home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr23 / cdisk704.zip / CATDOCS.ZIP / CATDISK.DOC < prev    next >
Text File  |  1993-07-07  |  295KB  |  6,931 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                            DISK CATALOG SYSTEM (CATDISK)
  20.  
  21.                                    USER'S GUIDE
  22.  
  23.  
  24.                                    Version 7.04
  25.  
  26.                                     Jul 7, 1993
  27.  
  28.  
  29.                      Copyright (C) 1986, 1993 By Rick Hillier
  30.  
  31.                                All Rights Reserved.
  32.  
  33.  
  34.  
  35.                                    _______
  36.                               ____|__     |               (tm)
  37.                            --|       |    |-------------------
  38.                              |   ____|__  |  Association of
  39.                              |  |       |_|  Shareware
  40.                              |__|   o   |    Professionals
  41.                            -----|   |   |---------------------
  42.                                 |___|___|    MEMBER
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                          T A B L E   O F   C O N T E N T S
  70.  
  71.       1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  72.            Dedication . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  73.            Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  74.            Features - CATDISK Program (Standard Version). . . . . . . . .   3
  75.            Features - CATDISK Program (DPMI-Compliant Version)  . . . . .   4
  76.            Features - CATLOOK Utility . . . . . . . . . . . . . . . . . .   4
  77.            Features - CATMGR Utility  . . . . . . . . . . . . . . . . . .   4
  78.            Features - DISKFILL Utility  . . . . . . . . . . . . . . . . .   4
  79.            Features - DUPCLEAN Utility  . . . . . . . . . . . . . . . . .   4
  80.            Licensing And Distribution . . . . . . . . . . . . . . . . . .   5
  81.            ASP . . .  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  82.  
  83.       2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . . . .   7
  84.            What You Should Have Received  . . . . . . . . . . . . . . . .   7
  85.            System Requirements (Standard Version) . . . . . . . . . . . .   8
  86.            System Requirements (DPMI-compliant Version) . . . . . . . . .   8
  87.            Initial Note On Archive Files  . . . . . . . . . . . . . . . .   8
  88.            Configuring CATDISK  . . . . . . . . . . . . . . . . . . . . .   9
  89.              Initial State of CATDISK Settings / Command Line Options . .  12
  90.              Limiting Which Disks DISKFILL Recommends For Backfilling . .  24
  91.              Limiting Which Files Get Cataloged . . . . . . . . . . . . .  25
  92.              Recalling A Previous Configuration . . . . . . . . . . . . .  26
  93.              Color Customization  . . . . . . . . . . . . . . . . . . . .  26
  94.              Saving Your Configuration  . . . . . . . . . . . . . . . . .  27
  95.              Default Settings . . . . . . . . . . . . . . . . . . . . . .  27
  96.              General Considerations When Configuring CATDISK  . . . . . .  27
  97.              Sample Configurations  . . . . . . . . . . . . . . . . . . .  28
  98.            IMPORTANT NOTE . . . . . . . . . . . . . . . . . . . . . . . .  29
  99.            Starting CATDISK . . . . . . . . . . . . . . . . . . . . . . .  30
  100.              If CATDISK/D Cannot Recognize Your Hardware  . . . . . . . .  30
  101.              Saving Parameters So You Don't Have To Type Them Each Time .  31
  102.  
  103.       3. USING CATDISK  . . . . . . . . . . . . . . . . . . . . . . . . .  32
  104.            Using The Menus  . . . . . . . . . . . . . . . . . . . . . . .  32
  105.            Selecting A Volume ID From A List  . . . . . . . . . . . . . .  33
  106.            Option 1  - Set Drive For Cataloging . . . . . . . . . . . . .  34
  107.            Option 2  - Settings And Toggles Menu  . . . . . . . . . . . .  35
  108.                1  - Set Current Catalog File  . . . . . . . . . . . . . .  35
  109.                2  - Pauses On/Off . . . . . . . . . . . . . . . . . . . .  36
  110.                3  - Change Printer Report Type  . . . . . . . . . . . . .  36
  111.                4  - Report Totals On/Off  . . . . . . . . . . . . . . . .  37
  112.                5  - File Comments On The Fly  . . . . . . . . . . . . . .  37
  113.               F1  - Main Archive Comment Copy . . . . . . . . . . . . . .  37
  114.               F2  - Extract 4DOS/NDOS Comments  . . . . . . . . . . . . .  37
  115.                6  - Set Current Report Destination  . . . . . . . . . . .  38
  116.                7  - Print Reports On Both Sides of Page . . . . . . . . .  38
  117.                8  - Archive Extract Setting . . . . . . . . . . . . . . .  39
  118.                9  - Comments When Archives Not Extracted  . . . . . . . .  39
  119.                0  - Aliases On/Off  . . . . . . . . . . . . . . . . . . .  40
  120.               F3  - Suggest Volume Label On/Off . . . . . . . . . . . . .  40
  121.               ESC - Return To Main Menu . . . . . . . . . . . . . . . . .  41
  122.            Option 3  - Labeling A Disk  . . . . . . . . . . . . . . . . .  42
  123.            Option 4  - Cataloging/Re-cataloging A Disk  . . . . . . . . .  43
  124.            Option 5  - UnCataloging A Disk  . . . . . . . . . . . . . . .  47
  125.            Option F1 - Add/Edit Summary Comments  . . . . . . . . . . . .  48
  126.            Option 6  - Add/Edit Comments By Volume ID . . . . . . . . . .  50
  127.            Option 7  - Add/Edit Comments By Filespec  . . . . . . . . . .  52
  128.  
  129.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  130.  
  131.                                       Page 1
  132.  
  133.  
  134.  
  135.            Option 8  - Add/Edit Comments By Comment . . . . . . . . . . .  52
  136.            Option 9  - Import Comments From A Text File . . . . . . . . .  52
  137.            Option 0 - Reports And Inquiries Menu  . . . . . . . . . . . .  55
  138.                Screen Based Reports . . . . . . . . . . . . . . . . . . .  55
  139.                Printer Based Reports  . . . . . . . . . . . . . . . . . .  56
  140.                Disk Based Reports . . . . . . . . . . . . . . . . . . . .  56
  141.                 1  - Show Disk Summary  . . . . . . . . . . . . . . . . .  57
  142.                 2  - Files For A Volume   . . . . . . . . . . . . . . . .  58
  143.                 3  - Files For An Archive . . . . . . . . . . . . . . . .  60
  144.                 4  - Files By Filespec  . . . . . . . . . . . . . . . . .  62
  145.                 5  - Files By Subdirectory  . . . . . . . . . . . . . . .  63
  146.                F1  - Files By Comment Text  . . . . . . . . . . . . . . .  64
  147.                F3  - Files By Comment Keywords  . . . . . . . . . . . . .  65
  148.                 6  - Files By Comment/Filename Text . . . . . . . . . . .  66
  149.                 7  - Unique Files Only  . . . . . . . . . . . . . . . . .  66
  150.                 8  - Duplicate Files Only . . . . . . . . . . . . . . . .  66
  151.                 9  - Volume Summary/Contents  . . . . . . . . . . . . . .  67
  152.                 0  - Sorted Full File Listings  . . . . . . . . . . . . .  67
  153.                Esc - Return To Main Menu  . . . . . . . . . . . . . . . .  67
  154.                F2  - Custom Reports . . . . . . . . . . . . . . . . . . .  68
  155.              Option <F4> - Temporary Exit To DOS  . . . . . . . . . . . .  72
  156.              Option <drive_letter> - Show Disk Directory  . . . . . . . .  73
  157.              Option ESC - Exit To DOS . . . . . . . . . . . . . . . . . .  73
  158.  
  159.         Appendix A - The Scroll Bar . . . . . . . . . . . . . . . . . . .  74
  160.         Appendix B - Archive Support  . . . . . . . . . . . . . . . . . .  75
  161.         Appendix C - CATLOOK Command Line Lookup Utility  . . . . . . . .  76
  162.         Appendix D - CATMGR - CATDISK Catalog Manager . . . . . . . . . .  77
  163.         Appendix E - DISKFILL - CATDISK's Optimal Disk Fill Utility . . .  81
  164.         Appendix F - DUPCLEAN: CATDISK'S File Cleanup Utility . . . . . .  91
  165.         Appendix G - Registration, Support And Updates  . . . . . . . . .  96
  166.         Appendix H - Questions And Answers  . . . . . . . . . . . . . . .  98
  167.         Appendix I - CATDISK Companion Programs . . . . . . . . . . . . . 101
  168.         Appendix J - Other Products Available . . . . . . . . . . . . . . 104
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  196.  
  197.                                       Page 2
  198.  
  199.  
  200.  
  201.                             1.  I N T R O D U C T I O N
  202.         DEDICATION
  203.  
  204.         This program is dedicated to the memory of my Grandfather, Earl Hillier
  205.         (Jan 1, 1909 - May 2, 1989).
  206.  
  207.  
  208.         OVERVIEW
  209.  
  210.         Overheard:  "I know I have that file in an archive on a disk SOMEWHERE!
  211.                     If only I could FIND it!"
  212.  
  213.         Sound familiar?  Many people I know are in this predicament.
  214.  
  215.         Enter CATDISK, the disk cataloging system.  CATDISK can help you
  216.         organize your disks in such a way that it is easy to find a file from
  217.         within a large collection by creating a collective directory of all the
  218.         files contained in your collection.  See the FEATURES section below for
  219.         a listing of CATDISK's capabilities.
  220.  
  221.         FEATURES - CATDISK PROGRAM (STANDARD VERSION)
  222.  
  223.         - Completely menu-driven and very easy to use.
  224.         - Configuration utility allows customization of the main features.
  225.         - All screen colors may be customized to your liking.
  226.         - Command line options can be stored in the DOS environment area
  227.           negating the need to memorize them.
  228.         - Cataloging/Uncataloging/Re-cataloging functions are fully automated.
  229.         - A disk volume label can be changed from within CATDISK.
  230.         - CATDISK can suggest sequential volume labels for you to use.
  231.         - You can catalog a disk under an alias instead of the volume label.
  232.         - Supports up to 65,534 files or 4,000 disks per catalog, which can be
  233.           reduced through the config program to better optimize memory usage.
  234.         - depending on available memory, CATDISK can read in 6000 files per
  235.           disk being cataloged, memory permitting.
  236.         - Supports up to 512 sub-directories per disk being cataloged.
  237.         - Supports multiple catalog files.
  238.         - Able to read the directory contents of all popular archive file
  239.           formats.  See the appendix on ARCHIVE SUPPORT for further details.
  240.         - Archive extraction is optional and can be set while in the program.
  241.         - You can attach a 43 character comment to each file in the catalog,
  242.           which can be done either while cataloging a disk, or at a later time.
  243.         - You can attach a 40 character comment to each disk in the catalog,
  244.           which can be done either while cataloging it, or at a later time.
  245.         - Can import comments from an ASCII text file, such as a BBS listing.
  246.         - Can read comments from ZIP, ZOO and DWC files.
  247.         - Can extract resolution/color information from GIF (Graphics
  248.           Interchange Format) files and include it as the default comment.
  249.         - Can read 4DOS/NDOS directory comments and add them to your catalog.
  250.         - Summary report shows disk capacity, space used and space free on
  251.           each disk in the catalog to aid in optimization of disk usage.
  252.         - Files can be viewed by DOS wildcards, Volume ID, ARCHIVE ID, or by
  253.           keywords or phrases in the file comments.
  254.         - Reports can be sent to screen, printer, or disk file.
  255.         - Custom reporting facility allows complete flexibility in defining
  256.           reports.
  257.         - Printer reports can be printed in a two-sided format to conserve
  258.           paper (this is, quite possibly, the first environmentally friendly
  259.           software product in terms of built-in reporting facilities).
  260.  
  261.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  262.  
  263.                                       Page 3
  264.  
  265.  
  266.  
  267.         FEATURES (DPMI-COMPLIANT VERSION)
  268.  
  269.         - operates in exactly the same manner as the standard version of
  270.           CATDISK.
  271.         - Increased support to 999,363 files or 4,000 disks per catalog.
  272.         - can read up to 65500 files per disk being cataloged.
  273.         - supports up to 2048 sub-directories per disk being cataloged.
  274.  
  275.  
  276.         FEATURES - "CATLOOK" UTILITY
  277.  
  278.         - small size allows it to be used when available memory is restricted.
  279.         - command line parameters allow any of CATDISK's reports to be created.
  280.         - output may be re-directed to a file or printer.
  281.         - can handle the upper limitations addressed by the DPMI-compliant
  282.           version of CATDISK.
  283.  
  284.         FEATURES - "CATMGR" UTILITY
  285.  
  286.         - can be used to split/merge complete or partial catalog files.
  287.         - menu driven for ease of use.
  288.         - point and shoot selection of individual cataloged volumes to move,
  289.           copy or delete
  290.         - can handle the upper limitations addressed by the DPMI-compliant
  291.           version of CATDISK.
  292.  
  293.         FEATURES - "DISKFILL" UTILITY
  294.  
  295.         - CATDISK's Optimal Disk Fill Utility automates offloading of files to
  296.           floppies using point and shoot file selection, and uses a "best-fit"
  297.           arrangement to minimize wasted disk space.  As disks are filled with
  298.           files, those disks can be cataloged as you go.  This program can also
  299.           recommend disks to use that have already been cataloged for
  300.           "backfilling" of free space.
  301.  
  302.         - DISKFILL fully supports 4DOS/NDOS file descriptions.
  303.  
  304.         - can handle the upper limitations addressed by the DPMI-compliant
  305.           version of CATDISK.
  306.  
  307.  
  308.         FEATURES - "DUPCLEAN" UTILITY
  309.  
  310.         - automates elimination of duplicate or redundant files through a point
  311.           & shoot file selection and through a flexible selection criteria
  312.           based on your disk catalog as maintained by CATDISK.
  313.  
  314.         - can handle the upper limitations addressed by the DPMI-compliant
  315.           version of CATDISK.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  328.  
  329.                                       Page 4
  330.  
  331.  
  332.  
  333.         LICENSING AND DISTRIBUTION
  334.  
  335.         CATDISK is copyright and has been released for distribution as
  336.         SHAREWARE.  Please note that a great deal of time and effort has been
  337.         invested in the development of this program.  You are granted a license
  338.         to try CATDISK for a reasonable trial period without risk.  If, after
  339.         this time, you find the program useful and intend to use it in managing
  340.         your disk collection, you are expected to register.
  341.  
  342.         The base registration fee is $29.  This will entitle you to continue to
  343.         use your copy of CATDISK beyond a reasonable trial period as well as
  344.         entitle you to program support.  With registration, we will give you a
  345.         simple procedure to follow, which will eliminate the shareware
  346.         introductory screen and the random keypress which accompanies it.
  347.  
  348.         The registration form, which should be included in the distribution
  349.         package that you received outlines the procedures for registering your
  350.         copy of the program.  Should you decide that you would like the latest
  351.         release on disk from us or would like to be able to obtain new releases
  352.         from our support BBS, The Shareware Connection, details on pricing may
  353.         be found on the registration form or in the appendix dealing with
  354.         support and upgrades that occurs later on in this user manual.
  355.  
  356.         Please keep in mind that we must have a registration form on file for
  357.         you before we can offer product support.
  358.  
  359.         Operators of electronic bulletin boards (Sysops) are encouraged to post
  360.         CATDISK for downloading by their users.
  361.  
  362.         CATDISK may be uploaded to and downloaded from commercial systems such
  363.         as CompuServe, the Source, and BIX, so long as the only charge paid by
  364.         the subscriber is for on-line time and there is no charge for the
  365.         program.  Those copying, sharing, and/or electronically transmitting
  366.         the program are required not to delete or modify the copyright notice
  367.         and restrictive notices from the program or documentation; anyone doing
  368.         so will be treated as a contributory copyright violator.
  369.  
  370.         If you are passing this program on to others, uploading it to a
  371.         bulletin board system, or including it in a users group library, do not
  372.         separate the files contained in the distribution archive - pass the
  373.         entire archive on to the intended party.  This ensures that those who
  374.         receive the program will have all the correct configuration utilities
  375.         and documentation necessary to get CATDISK up and running quickly.  A
  376.         listing of what files you should have and the purpose of each is listed
  377.         later in this manual.
  378.  
  379.         The CATDISK documentation may not be modified by users. The program may
  380.         not be separated from the documentation when distributed.  Printed or
  381.         Photocopies ("Xeroxed") copies of the CATDISK documentation (i.e., this
  382.         manual) may not be distributed or sold without the written permission
  383.         of the author.
  384.  
  385.         No other person other than the author, Rick Hillier, may accept payment
  386.         or royalties for this program.
  387.  
  388.         This license to use CATDISK does NOT include the right to distribute or
  389.         sell CATDISK.  Distribution terms are detailed in the file VENDOR.DOC
  390.         which is included with this package.
  391.  
  392.  
  393.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  394.  
  395.                                       Page 5
  396.  
  397.  
  398.  
  399.         ASP
  400.  
  401.         This program is produced by a member of the Association of Shareware
  402.         Professionals (ASP).  ASP wants to make sure that the shareware
  403.         principle works for you.  If you are unable to resolve a
  404.         shareware-related problem with an ASP member by contacting the member
  405.         directly, ASP may be able to help.  The ASP Ombudsman can help you
  406.         resolve a dispute or problem with an ASP member, but does not provide
  407.         technical support for members' products.  Please write to the ASP
  408.         Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  409.         message via CompuServe mail to ASP Ombudsman 70007,3536
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  460.  
  461.                                       Page 6
  462.  
  463.  
  464.  
  465.                            2.  G E T T I N G   S T A R T E D
  466.  
  467.         WHAT YOU SHOULD HAVE RECEIVED
  468.  
  469.         CATDISK is distributed in the form of a self-extracting LHA archive
  470.         containing five files as follows:
  471.  
  472.         README.1ST   - Urgent program notes - IMPORTANT -- READ THIS FILE!
  473.         WHAT'S.NEW   - Changes made to CATDISK since the last release.
  474.  
  475.         CATPROGS.EXE - A self-extracting archive containing the CATDISK program
  476.                        files as follows:
  477.  
  478.            CATDISK.EXE  - The CATDISK program file.
  479.            CDISKCFG.EXE - The CATDISK configuration program.
  480.            CDISKCVT.EXE - Conversion utility for converting old CATDISK files
  481.                           to the newest format - See README.1ST before running.
  482.            CLEANCAT.EXE - Cleanup utility for catalog entries containing volume
  483.                           labels containing null characters - See the
  484.                           README.1ST file before running.
  485.  
  486.         CATUTILS.EXE - A self-extracting archive containing the following
  487.                        CATDISK utility programs:
  488.  
  489.            CATLOOK.EXE  - The CATDISK command line utility (lookup program).
  490.            CATMGR.EXE   - The CATDISK catalog file manager (split/merge/delete/
  491.                           copy utility).
  492.            DISKFILL.EXE - Optimal disk fill utility with MANY handy features.
  493.            DUPCLEAN.EXE - Duplicate file cleanup utility.
  494.  
  495.         CATDOCS.EXE  - A self-extracting archive containing the CATDISK
  496.                        documentation files as follows:
  497.  
  498.            PRINTDOC.EXE - A utility program to print the various CATDISK
  499.                           documentation files.  See README.1ST for details.
  500.            CATDISK.DOC  - The manual you are now reading.
  501.            CATDISK.HST  - Revision history for CATDISK since its initial
  502.                           release in October 1986.
  503.            REGISTER.FRM - The registration form for this product.
  504.            SITE.LIC     - The site license registration form for this product.
  505.            VENDOR.DOC   - Vendor distribution agreement form.
  506.  
  507.         To extract the files, just run CATPROGS.EXE and/or CATDOCS.EXE and the
  508.         files will be automatically extracted to the current directory.
  509.  
  510.         We also distribute a DPMI-compliant version of the CATDISK program
  511.         itself (we'll call it CATDISK/D), supporting higher capacities than the
  512.         standard version of CATDISK.  The naming convention for version 7.04,
  513.         for example, would be either CDSK704D.EXE or CD704D.EXE, depending on
  514.         the location from which you download CATDISK. The archive is unpacked
  515.         in the same manner as above.  The four files listed below should be
  516.         copied to the same directory as the other CATDISK program files.
  517.  
  518.         This archive will contain:
  519.  
  520.           CATDISKD.EXE - the DPMI-compliant version of the CATDISK program.
  521.           RTM.EXE      - the Borland International DPMI Run-Time Manager.
  522.           DPMI16BI.OVL - The Borland International DPMI Overlay File.
  523.           DPMIINST.EXE - Configures RTM.EXE to your system specifications.
  524.  
  525.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  526.  
  527.                                       Page 7
  528.  
  529.  
  530.  
  531.         SYSTEM REQUIREMENTS (STANDARD VERSION)
  532.  
  533.         . True IBM-compatible computer with an 8088 processor or above.
  534.         . DOS v2.00 or above.
  535.         . At least one floppy disk drive (Hard Drive Highly Recommended).
  536.         . 320K RAM - if more is available, CATDISK will have greater internal
  537.                      capacity for reading new files off of the disks being
  538.                      cataloged and will run more efficiently.
  539.  
  540.         SYSTEM REQUIREMENTS (CATDISK/D - DPMI-COMPLIANT VERSION)
  541.  
  542.         . True IBM-compatible computer with an 80286 processor or above.
  543.         . DOS v3.00 or above.
  544.         . Hard disk with sufficient capacity to hold your data.
  545.         . 640K Base Memory and 512K Extended Memory or higher (more is better!)
  546.  
  547.  
  548.         INITIAL NOTE ON ARCHIVE FILES
  549.  
  550.         At various points in this user manual, references to ARCHIVE files are
  551.         made.  This is a collective term describing a file that actually
  552.         contains more than one file.  The contained files may or may not be
  553.         compressed.  Currently, this refers to ARC, ARJ, DWC, HYP, LBR, LZH,
  554.         LZS, PAK, ZIP and ZOO files.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  592.  
  593.                                       Page 8
  594.  
  595.  
  596.  
  597.         CONFIGURING CATDISK
  598.  
  599.         Many features of CATDISK may be permanently set from the configuration
  600.         program, CDISKCFG.EXE.  When you start this program, please make sure
  601.         that the correct versions of the program files CATDISK.EXE,
  602.         CATLOOK.EXE, CATMGR.EXE and DISKFILL.EXE are in the current drive and
  603.         directory, otherwise you will get an error message.
  604.  
  605.         There are several utilities available that allow you to compress an
  606.         executable file such that it remains executable, but takes up less room
  607.         on your disk.  Examples of such programs are PKLITE and LZEXE.  If you
  608.         use such programs on any of the CATDISK program files, CDISKCFG will
  609.         not be able to find the configuration information in those two files.
  610.         Once you've configured CATDISK and its companion programs to your
  611.         liking, it's okay to compress them after making copies of the
  612.         originals.
  613.  
  614.         Upon startup, the configuration program will read the current settings
  615.         defined in "CATDISK.EXE", after which, the configuration screen will be
  616.         presented.  You may change any given item on this screen by using the
  617.         <Cursor UP> and <Cursor DOWN> keys to highlight the title of the
  618.         desired field.  The bottom portion of the screen will contain any
  619.         additional information as well as any instructions on how to change the
  620.         selected item.
  621.  
  622.         A discussion of the 9 items on this list follows:
  623.  
  624.          1) SCREEN UPDATE METHOD
  625.  
  626.             You may choose between having your screen updated by using your
  627.             computer's built in BIOS routines, or by using a faster DIRECT
  628.             screen update method.  Using the BIOS is much slower than using
  629.             direct access, but maintains compatibility with such operating
  630.             environments as TopView, Desqview, and DoubleDOS.
  631.             Choosing DIRECT screen access is much quicker, but will be
  632.             incompatible with most multitasking programs such as the above
  633.             mentioned due to the fact that they cannot handle "ill-behaved"
  634.             programs that write directly to the screen.
  635.  
  636.             If you chose DIRECT screen access, a second test is made if you
  637.             have a GRAPHICS display connected in your system.  Some video
  638.             adapters have the nasty side effect of producing static, or "snow"
  639.             when the video memory is accessed directly.  This test will do
  640.             multiple direct access to the video ram on your graphics adapter.
  641.             When you hit a key to stop the test, you will be asked if you saw
  642.             static on the screen.
  643.  
  644.             If you answer "Y" to the prompt, CATDISK will check for horizontal
  645.             retrace before writing to the display.  This will result in a
  646.             slightly slower screen response than normal, but it is almost
  647.             negligible.
  648.  
  649.             If you are not running under a multitasking system, or are using
  650.             DoubleDos in dual screen mode, I would recommend that you use
  651.             DIRECT screen access, as it's much quicker.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  658.  
  659.                                       Page 9
  660.  
  661.  
  662.  
  663.          2) COLOR OR B & W
  664.  
  665.             This option is self-explanatory.  The appearance of the setup
  666.             screen will depend on the setting of this field.
  667.  
  668.          3) NUMBER OF REPORT LINES PER PAGE
  669.  
  670.             The number of lines per page field will enable you to tell CATDISK
  671.             the number of lines of data (EXCLUDING headings) that it should
  672.             place on each page of printer or disk output.  This may be any
  673.             number between 0 and 255.  Entering zero will disable page breaking
  674.             and the output will be presented in a continuous stream with one
  675.             title at the top.
  676.  
  677.          4) PRINTER STARTUP STRING
  678.  
  679.             The printer start up string is a series of ASCII codes (entered
  680.             here as their ASCII VALUES) that will tailor your reports to the
  681.             format you desire.  For example, I use an Epson printer and like to
  682.             set it to 1/8" spacing and get 80 report lines per page.  To do
  683.             this, I send a startup string of "<Esc> <0>" to set this print
  684.             mode.  To enter this string in the configuration program, I would
  685.             enter it as "027 048" without the quotes.  The numbers are simply
  686.             the ASCII values of the characters I wish to send.  If you have a
  687.             setup string entered here and wish to clear it, simply hit <Return>
  688.             in response to the prompt in the bottom area of the screen.
  689.  
  690.          5) PRINTER FINISHING STRING
  691.  
  692.             The printer finishing string is commonly used to reverse the
  693.             startup string entered above and is entered in exactly the same
  694.             way.  In the example above, I would use "<Esc> <2>", which would be
  695.             entered as "027 050" without the quotes.  If you have a setup
  696.             string entered here and wish to clear it, simple hit <Return> in
  697.             response to the prompt in the bottom area of the screen.
  698.  
  699.          6) DEFAULT ARCHIVE EXTRACT STATE
  700.  
  701.             This will control the way CATDISK handles any ARCHIVE files that
  702.             it might encounter when cataloging your disks as well as whether
  703.             or not files contained within archives will be included in a
  704.             report.
  705.  
  706.             If you set it to OFF, CATDISK will NOT extract any archive files
  707.             that it finds on your disks or include files in the catalog
  708.             contained within archives in any of your reports.
  709.  
  710.             If you set it to ON, CATDISK will expand EVERY ARCHIVE file that it
  711.             finds on your disks.  Any files already cataloged that are
  712.             contained within archive files will be included in any reports.
  713.  
  714.             If you set it to QUERY, CATDISK will ask you for permission to
  715.             expand an ARCHIVE file each time it encounters one.  Any files
  716.             already cataloged that are contained within archive files will be
  717.             included in any reports.
  718.  
  719.             This can be changed temporarily while running CATDISK.
  720.  
  721.  
  722.  
  723.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  724.  
  725.                                       Page 10
  726.  
  727.  
  728.  
  729.          7) DEFAULT CATALOG DRIVE
  730.  
  731.             The default catalog drive is the drive that CATDISK will assume you
  732.             wish to use for labeling disks and reading them for cataloging
  733.             purposes.  This drive may still be changed at startup time (see
  734.             STARTING CATDISK), or from the menu when CATDISK is running.
  735.  
  736.             If you are running on single floppy based system, I would recommend
  737.             that you set this drive to the same drive ID that CATDISK will be
  738.             run from.  CATDISK will prompt you to enter the appropriate disks
  739.             at the appropriate time, and will eliminate potential problems with
  740.             the disk caching feature if enabled (See the file README.1ST).
  741.  
  742.          8) CATALOG FILE DIRECTORY
  743.  
  744.             The catalog file directory is the location in your system that
  745.             CATDISK will look for and create its catalog files.  This path may
  746.             contain a drive designator, so that the catalog files may reside on
  747.             a different drive than CATDISK itself, such as a ramdisk (in this
  748.             case don't forget to copy the files to a real disk before you turn
  749.             off or reboot your machine).
  750.  
  751.             If this field is blank, the default drive and directory will be
  752.             used.
  753.  
  754.          9) DISKS/FILES PER CATALOG
  755.  
  756.             The maximum number of disks and files per catalog is simply that.
  757.             When CATDISK starts, it allocates its work space according to this
  758.             setting.  The higher the setting, the more memory will be used,
  759.             making less memory available for tasks such as reading in file
  760.             entries from a disk being cataloged and sorting operations.
  761.  
  762.             The current limitations for CATDISK are 4000 disks or 65534 files
  763.             per catalog, whichever comes first.  CATDISK/D can handle 999363
  764.             files per catalog.
  765.  
  766.             You can change these settings by either typing in the desired
  767.             numbers directly or use the cursor keypad to change the settings as
  768.             per the instructions that will show on your screen.  The direction
  769.             of the arrow (either before or after the slash between the two
  770.             settings) will indicate which setting you are affecting when you
  771.             use the cursor keypad.
  772.  
  773.  
  774.     
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  790.  
  791.                                       Page 11
  792.  
  793.  
  794.  
  795.         INITIAL STATE OF CATDISK SETTINGS / COMMAND LINE OPTIONS
  796.  
  797.         There are a number of options available that customize the way that
  798.         CATDISK and DISKFILL perform their respective functions.  Many of the
  799.         options that pertain to CATDISK itself can be set through the Settings
  800.         & Toggles menu (discussed later in this manual).
  801.  
  802.         All of these settings have defaults, which can be overridden in this
  803.         section of the configuration utility or by command line options.  We
  804.         will discuss the command line options pertinent to CATDISK in this
  805.         section as well, as they go hand in hand with what will be discussed
  806.         here.
  807.  
  808.         Although there are several settings that apply to the DISKFILL utility
  809.         here, the command line options for DISKFILL will be discussed in the
  810.         appendix of this manual that deals with that program as well as this
  811.         section.
  812.  
  813.         To bring up the settings screen, hit <F4> from the main screen of the
  814.         CDISKCFG utility.  You will then see a screen that contains various
  815.         settings, all (with the exception of the first item) of which contain a
  816.         setting heading and two or more sets of square brackets followed by
  817.         text indicating each item for each setting.  One of the sets of square
  818.         brackets will contain a small block indicating that that particular
  819.         option is turned on.
  820.  
  821.         To select a setting, use the <Up Arrow> and <Down Arrow> keys.  To
  822.         change a setting, use the <Left Arrow> and <Right Arrow> keys. The
  823.         exception to this is the first setting, the starting catalog file,
  824.         which will be discussed with that setting a little later.
  825.  
  826.         When you have all settings the way you want them, hit <Esc> to return
  827.         to the main options screen.
  828.  
  829.         SETTINGS
  830.  
  831.          1) Starting Catalog
  832.  
  833.             CATDISK keeps its catalogs in a system of two files and ties them
  834.             together by using a common base catalog name followed by an
  835.             extension of .SUM for the disk summary info or an extension of .DTA
  836.             for the catalog data itself.  By default, the name "CATDISK" will
  837.             be used at program startup.  Even though you can change the active
  838.             catalog file at any time, it can be desirable to have CATDISK use a
  839.             different catalog set right off the bat.  By placing the name of
  840.             the catalog set that you wish to use when CATDISK is started, you
  841.             can override the default name of CATDISK.  If the catalog name that
  842.             you specify does not exist, a new, empty set will be created.
  843.  
  844.             If you use a single question mark "?" for the catalog name, CATDISK
  845.             will bring up a point and shoot list of available catalogs for you
  846.             to use.  If you hit <Esc> from this list, CATDISK will exit to DOS.
  847.  
  848.             This option also applies to DISKFILL with the exception that making
  849.             the catalog name "?" will cause DISKFILL to ignore it.
  850.  
  851.             The same thing applies to DUPCLEAN.
  852.  
  853.  
  854.  
  855.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  856.  
  857.                                       Page 12
  858.  
  859.  
  860.  
  861.             Change this setting by typing in the name of the catalog set that
  862.             you wish to use.
  863.  
  864.             Command line parameter:  /Fcatalogname  (CATDISK and DISKFILL)
  865.  
  866.               Note that there is no space between the /F and the filename.
  867.               Using this at startup will override the setting made in the
  868.               CDISKCFG program.  /F? will activate the point and shoot list
  869.               described above.
  870.  
  871.          2) Report Destination
  872.  
  873.             Setting  Description                                    Parameter
  874.  
  875.             Scrn     Sends report output to the screen.                /R1
  876.             LPT1     Sends report output to parallel printer #1.       /R2
  877.             LPT2     Sends report output to parallel printer #2.       /R3
  878.             DISK     Sends report output to a disk file that you       /R4
  879.                      specify at the time that the report is created.
  880.             ASK ME   CATDISK will prompt you for a report              /R5
  881.                      destination before the report is created.
  882.  
  883.          3) Catalog Report Format
  884.  
  885.             Controls the screen-based report format for the catalog entries.
  886.  
  887.             Setting           Items Included In Report                Parameter
  888.  
  889.             Stat              Filename, Volume ID, Archive ID, size,     /L0
  890.                               date, time and file attributes.
  891.  
  892.             Sdir              Subdirectory,Filename, Volume ID, Archive  /L1
  893.                               ID, size, date and time.
  894.  
  895.             File Cmts         Filename, Volume ID, Archive ID and full   /L2
  896.                               file comment (all 43 characters).
  897.  
  898.             Sdir + File Cmts  Subdirectory, Filename, Volume ID,         /L3
  899.                               Archive ID and short file comment (first
  900.                               30 characters).
  901.  
  902.          4) Summary Report Format
  903.  
  904.             Controls the screen-based report format for the disk summary.
  905.  
  906.             Setting        Items Included In Report                   Parameter
  907.  
  908.             Statistics     Disk volume, disk capacity, number of        /SL0
  909.                            files on the disk, space used, free
  910.                            space, slack % and date last cataloged.
  911.  
  912.             Comments       Disk volume, disk capacity, free space       /SL1
  913.                            and disk comment.
  914.  
  915.         
  916.  
  917.  
  918.  
  919.  
  920.  
  921.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  922.  
  923.                                       Page 13
  924.  
  925.  
  926.  
  927.          5) Printed Report Format
  928.  
  929.             Controls the printer and disk-based formats for all reports.
  930.  
  931.             Setting     Items Included In Report                      Parameter
  932.  
  933.             Stat        Subdirectory, Filename, Volume ID, Archive,      /P0
  934.                         File Size, File Date, File Time, and File
  935.                         Attribute in the file reports; All summary
  936.                         information EXCEPT comments in summary report.
  937.  
  938.             Cmts        Filename, Volume ID, Archive And Full Comment    /P1
  939.                         (43 chars) in the file reports; Volume ID,
  940.                         Disk Capacity, Free Space and Comment in the
  941.                         summary report.
  942.  
  943.             Sdirs+Cmts  Subdirectory, Filename, Volume ID, Archive and   /P2
  944.                         truncated file comment (30 characters) in file
  945.                         reports; Volume ID, Disk Capacity, Free Space
  946.                         and Comment in the summary report.
  947.  
  948.             All Info    All information (Subdirectory, Filename, Volume  /P3
  949.                         ID, Archive, File Size, File Date, File Time,
  950.                         File Attribute and Comment in file reports;
  951.                         All details in the summary report.  It is
  952.                         assumed that your printer is set up to product 132
  953.                         column reports (possibly set up via the printer
  954.                         starting string that can be set on the main
  955.                         configuration screen).
  956.  
  957.          6) Two Sided Reports
  958.  
  959.             Off - CATDISK paginates printed reports continuously with pages in
  960.                   sequential order.
  961.  
  962.             On  - CATDISK produces odd numbered pages of a printed report
  963.                   first, then pauses to allow you to remove the paper and
  964.                   re-insert it back in the printer such that the even numbered
  965.                   pages will be printed on the back of the previously printed
  966.                   odd pages, thus conserving paper.
  967.  
  968.             Command line parameter:  /2
  969.  
  970.               By default, this feature is turned off.  Adding /2 to the command
  971.               line will force it on.
  972.  
  973.          7) Report Totals
  974.  
  975.             Off - CATDISK will not show any report totals at the bottom of
  976.                   screen, printer and disk-based reports.
  977.  
  978.             On  - CATDISK will add up columns such as total files, bytes, free
  979.                   space, etc. and report those totals at the end of a report or
  980.                   at the bottom of a screen-based report.
  981.  
  982.             Command line parameter:  /NT
  983.  
  984.               By default, the report totals are turned on.  Adding /NT on the
  985.               command line will turn it off.
  986.  
  987.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  988.  
  989.                                       Page 14
  990.  
  991.  
  992.  
  993.          8) Archive Extract Setting (In Reports)
  994.  
  995.             Affects Reports -   The Archive Extract setting (changeable from
  996.                                 the main configuration screen or from CATDISK's
  997.                                 Settings & Toggles menu) will affect whether or
  998.                                 not files contained inside archive files in
  999.                                 your catalog will be included in a report.  If
  1000.                                 set to OFF, they will not be included; setting
  1001.                                 it to ON or QUERY will cause CATDISK to include
  1002.                                 them.
  1003.  
  1004.             Ignore In Reports - ALL Files will be included in a report
  1005.                                 regardless of the Archive Extract setting.
  1006.  
  1007.             Command line parameter:  /ALLFILES
  1008.  
  1009.               Forces this setting to "Ignore In Reports"
  1010.  
  1011.          9) Sort Summary Report By
  1012.  
  1013.             Disk Volume Label - Summary report to screen is sorted this way.
  1014.  
  1015.             Free Disk Space   - Summary report to screen is sorted by ascending
  1016.                                 free disk space.
  1017.  
  1018.             Command line parameter:  /SF
  1019.  
  1020.               This will force this setting to be sorted by free disk space.
  1021.               You can still toggle between the two settings from within the
  1022.               summary report by pressing the <Space Bar>.  This setting just
  1023.               defines the starting order.
  1024.  
  1025.         10) Main Archive Comment Extract
  1026.  
  1027.             Off - Disables the feature mentioned below this line.
  1028.  
  1029.             On  - When not instructed to read the directory contents of ZIP or
  1030.                   ARJ files, CATDISK will attempt to read in the main comment
  1031.                   from any ZIP or ARJ file that it encounters.  Additionally,
  1032.                   when CATDISK encounters a GIF file, it will attempt to read
  1033.                   in the resolution/color information from it and place it in
  1034.                   the comment field.
  1035.  
  1036.             Command line parameter:  /NC
  1037.  
  1038.               Forces this setting to OFF.
  1039.  
  1040.         11) Main Archive Comment Copy
  1041.  
  1042.             Off - Disables the feature mentioned below this line.
  1043.  
  1044.             On  - CATDISK has a feature whereby any ZIP or ARJ files containing
  1045.                   a main comment that get expanded will have that main comment
  1046.                   inserted into the comment area of any file entry extracted
  1047.                   from that ZIP/ARJ file that does not already have a comment.
  1048.  
  1049.             Command line parameter:  /NCC
  1050.  
  1051.               Forces this setting to OFF.
  1052.  
  1053.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1054.  
  1055.                                       Page 15
  1056.  
  1057.  
  1058.  
  1059.         12) 4DOS/NDOS Comments
  1060.  
  1061.             Off - Disables the feature mentioned below this line.  You might
  1062.                   need to do so if this feature is causing you any problems
  1063.                   (such as having a file called DESCRIPT.ION from another
  1064.                   application).
  1065.  
  1066.             On  - This setting should normally be left on. 4DOS and Norton DOS
  1067.                   (NDOS), are command interpreter (i.e. COMMAND.COM)
  1068.                   replacements which greatly enhance the functionality of DOS.
  1069.                   One feature that is particularly handy is their ability to
  1070.                   add comments to your directory entries at the DOS level using
  1071.                   a command called DESCRIBE.
  1072.  
  1073.                   If you copy or move a file from the command prompt, that
  1074.                   comment goes right along with the file (the DISKFILL utility,
  1075.                   discussed later in this user manual, can also do this).
  1076.                   These comments are stored in a hidden file, DESCRIPT.ION in
  1077.                   each subdirectory where file comments are contained.
  1078.  
  1079.                   When CATDISK encounters such a file, the comments are
  1080.                   automatically read into your catalog where applicable and the
  1081.                   hidden file is cataloged with the comment "4DOS/NDOS File
  1082.                   Descriptions."  If you do not want this file cataloged at
  1083.                   all, you can do so by adding "DESCRIPT.ION" to the file
  1084.                   exclude specs screen.
  1085.  
  1086.                   Command line parameter:  /N4  (CATDISK and DISKFILL)
  1087.  
  1088.                     Forces this setting off.
  1089.  
  1090.         13) Volume Label Aliases
  1091.  
  1092.             Off - Disables the feature mentioned below this line.
  1093.  
  1094.             On  - Activates the "ALIAS" feature whereby you will be able to
  1095.                   override the name under which a disk will be cataloged.
  1096.                   Normally, CATDISK will catalog a disk under the volume label.
  1097.                   This will enable you to optionally catalog the disk under a
  1098.                   different name without changing the actual volume label on
  1099.                   the disk being cataloged.
  1100.  
  1101.             Command line parameter:  /ALIAS
  1102.  
  1103.               Turns the above feature on.
  1104.  
  1105.         14) Volume Label Suggest
  1106.  
  1107.             Off - No suggestions for volume labels are made.
  1108.  
  1109.             On  - Have CATDISK suggest sequential volume labels for you to use
  1110.                   when adding a NEW volume label to a disk based on your last
  1111.                   entry or the contents of your catalog file.  You may still
  1112.                   override the suggestion with a label of your own choice.  See
  1113.                   the section "Labeling A Disk" for further details.
  1114.  
  1115.             Command line parameter:  /SV
  1116.  
  1117.               Turns this feature on.
  1118.  
  1119.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1120.  
  1121.                                       Page 16
  1122.  
  1123.  
  1124.  
  1125.         15) Add/Edit File Comments:
  1126.  
  1127.             On Demand Only         - Return to menu immediately after
  1128.                                      cataloging a disk.  Comments may only be
  1129.                                      edited on demand via the comment editing
  1130.                                      facilities available from the menus.
  1131.  
  1132.             As Disks Are Cataloged - After cataloging a disk, CATDISK will
  1133.                                      proceed to sections of the program where
  1134.                                      you may add/modify the disk and file
  1135.                                      comments for the volume that you just
  1136.                                      cataloged.
  1137.  
  1138.             Command line parameter:  /AC
  1139.  
  1140.               Sets the above feature to "As Disks Are Cataloged"
  1141.  
  1142.  
  1143.         16) Add/Edit Disk Comments:
  1144.  
  1145.             On Demand Only         - Continue with cataloging operations. Disk
  1146.                                      comments may only be edited on demand via
  1147.                                      the comment editing facilities available
  1148.                                      from the menus.
  1149.  
  1150.             As Disks Are Cataloged - After cataloging each disk, CATDISK will
  1151.                                      ask you for a disk comment before it
  1152.                                      updates the summary file.
  1153.  
  1154.             Command line parameter:  /ADC
  1155.  
  1156.               Sets the above feature to "As Disks Are Cataloged"
  1157.  
  1158.  
  1159.         17) Comments In Catalog
  1160.  
  1161.             Retain If In Catalog - CATDISK will not override a file comment
  1162.                                    that already exists in the catalog file with
  1163.                                    one found on disk (eg. in a ZIP file, or in
  1164.                                    a 4DOS description).  This is to protect any
  1165.                                    comment "massaging" that you may have done
  1166.                                    when that disk was previously cataloged.
  1167.                                    Overriding that comment would undo any
  1168.                                    editing that you may have done.
  1169.  
  1170.             Override From Disk   - CATDISK overrides any file comments in the
  1171.                                    catalog with those read from the disk during
  1172.                                    the process of cataloging it.  If you are
  1173.                                    re-cataloging a disk, any comments that you
  1174.                                    may have "massaged" will be overridden with
  1175.                                    those found on disk.
  1176.  
  1177.             This option may only be set at program startup - there is no option
  1178.             in the settings & toggles menu to change it.  This option should be
  1179.             used with caution.
  1180.  
  1181.             Command line parameter:  /DISKCOM
  1182.  
  1183.               Forces the "Override From Disk" setting.
  1184.  
  1185.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1186.  
  1187.                                       Page 17
  1188.  
  1189.  
  1190.  
  1191.         18) Status Indicators
  1192.  
  1193.             Off - Suppress status indicators during processing.  This speeds up
  1194.                   processing time slightly.
  1195.  
  1196.             On  - Show status indicators during processing.  Status indicators
  1197.                   are there simply to indicate that the computer is actually
  1198.                   doing something useful.
  1199.  
  1200.             Command line parameter:  /NS
  1201.  
  1202.               Turns the above feature off.
  1203.  
  1204.  
  1205.         19) Cataloging File Status
  1206.  
  1207.             Off - CATDISK will only show the summary information when updating
  1208.                   a catalog file.  This will speed up processing somewhat,
  1209.                   particularly if the disk being processed has many files.
  1210.  
  1211.             On -  CATDISK will show each file entry in the catalog that is
  1212.                   affected by the current catalog/re-catalog/un-catalog
  1213.                   operation in addition to a summary of the changes.
  1214.  
  1215.             Command line parameter:  /NOLIST
  1216.  
  1217.               Turns the above feature off.
  1218.  
  1219.  
  1220.         20) Optional Pauses
  1221.  
  1222.             Off - CATDISK will not pause after cataloging/un-cataloging a disk.
  1223.                   CATDISK will not prompt for a disk in drive X: before
  1224.                   cataloging or reading a disk directory unless absolutely
  1225.                   necessary.
  1226.  
  1227.             On  - CATDISK will pause after cataloging/un-cataloging a disk.
  1228.                   CATDISK will always prompt for a disk in drive X: before
  1229.                   cataloging or reading a disk directory.
  1230.  
  1231.             Command line parameter:  /NP
  1232.  
  1233.               Turns the above feature off.
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1252.  
  1253.                                       Page 18
  1254.  
  1255.  
  1256.  
  1257.         21) Initial Pause At Start
  1258.  
  1259.             Off - When CATDISK loads, it will go right to the main menu after
  1260.                   the shareware introductory screen is viewed (registered users
  1261.                   do not see the intro screen).  This is the recommended
  1262.                   setting for those with hard drives where the catalog files
  1263.                   are available right away.
  1264.  
  1265.             On  - CATDISK will pause after it is loaded so that you may remove
  1266.                   the program disk (not needed during the session) and insert
  1267.                   the data disk. This setting is only needed if you are running
  1268.                   on a single drive system where the CATDISK program must first
  1269.                   be loaded and then the disk with the catalog files gets
  1270.                   inserted in the drive.
  1271.  
  1272.             Command line parameter:  /IP
  1273.  
  1274.               Turns the above setting on.
  1275.  
  1276.  
  1277.         22) Volume Exists Warning
  1278.  
  1279.             Off - CATDISK will not warn you if you are about to catalog a disk
  1280.                   that already exists in the catalog (see discussion for "on"
  1281.                   below).  CATDISK will create new catalog files when you
  1282.                   change the active catalog from the Setting & Toggles menu
  1283.                   without warning you that it is about to do so.
  1284.  
  1285.             On  - When you catalog a disk containing a Volume ID that already
  1286.                   exists in the current catalog, CATDISK will warn you to that
  1287.                   effect, and will ask you for verification before proceeding
  1288.                   to catalog that disk.  The reason behind this is that there
  1289.                   is always the possibility of two different disks having the
  1290.                   same Volume ID.  Cataloging one would mean that the files
  1291.                   from the other would be un-cataloged in the same process.
  1292.  
  1293.                   CATDISK will also warn you that it is about to create new
  1294.                   catalog files when you change the active catalog from the
  1295.                   Settings & Toggles menu.
  1296.  
  1297.             Command line parameter:  /NW
  1298.  
  1299.               Turns the above option off.
  1300.  
  1301.  
  1302.         23) Sound Control
  1303.  
  1304.             Off - CATDISK will operate silently.
  1305.  
  1306.             On  - CATDISK will make sounds at appropriate points in the program
  1307.                   (eg. error messages or warnings).
  1308.  
  1309.             Command line parameter:  /QUIET    (CATDISK, DISKFILL and DUPCLEAN)
  1310.  
  1311.               Turns the above option off.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1318.  
  1319.                                       Page 19
  1320.  
  1321.  
  1322.  
  1323.         24) Date Format
  1324.  
  1325.             MMM DD,YYYY - eg. MAR 13, 1993.  Easier to read and avoids
  1326.                           ambiguous dates.
  1327.  
  1328.             YYYY-MM-DD  - eg. 1993-03-13.  Useful for producing an external
  1329.                           listing on which you will be using an external sort
  1330.                           program to sort the file by date.
  1331.  
  1332.             Command line parameter:  /ND       (CATDISK, DISKFILL and DUPCLEAN)
  1333.  
  1334.               Forces the YYYY-MM-DD date format.
  1335.  
  1336.  
  1337.         25) Allow Shell To DOS
  1338.  
  1339.             Off - CATDISK will ignore the <F4> - Shell To DOS key.  Useful
  1340.                   when running CATDISK from a menu program in restricted
  1341.                   circumstances where it may not be desirable to allow users
  1342.                   access to the DOS prompt via this function.  If <F4> is
  1343.                   pressed from a menu, a short beep will sound (if sound is
  1344.                   turned on).
  1345.  
  1346.             On  - CATDISK will allow the <F4> - Shell To DOS key.
  1347.  
  1348.             Command line parameter:  /NOSHELL
  1349.  
  1350.               Turns the above feature off.
  1351.  
  1352.         26) Verify Exit From Program
  1353.  
  1354.             Off - When you press the <Esc> key from the main menu, CATDISK will
  1355.                   promptly exit to DOS.
  1356.  
  1357.             On  - When you press the <Esc> key from the main menu, CATDISK will
  1358.                   give you a YES/NO prompt asking if you really want to leave
  1359.                   the program.
  1360.  
  1361.             Command line parameter:  /EXITV
  1362.  
  1363.               Turns the above feature on.
  1364.  
  1365.  
  1366.         27) Menu Arrow Pointers
  1367.  
  1368.             Static   - Menu arrow pointers used for point and shoot selection
  1369.                        of options will be solid on the screen.
  1370.  
  1371.             Blinking - Menu arrow pointers will blink to stand out more.
  1372.  
  1373.             Command line parameter:  /NOBLINK
  1374.  
  1375.               Forces this setting to STATIC
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1384.  
  1385.                                       Page 20
  1386.  
  1387.  
  1388.  
  1389.         28) Files/Disk Only Prompt
  1390.  
  1391.             Off - CATDISK will automatically catalog all files that it reads
  1392.                   from the disk being cataloged that pass the include/exclude
  1393.                   filespecs (which can be set from within the configuration
  1394.                   utility, CDISKCFG).
  1395.  
  1396.             On  - After updating the summary file, CATDISK will ask you if you
  1397.                   want to catalog just the disk only, or catalog all files read
  1398.                   from the disk being cataloged that pass the include/exclude
  1399.                   filespecs.
  1400.  
  1401.  
  1402.         29) DISKFILL Autotag Files
  1403.  
  1404.             Off - DISKFILL will not automatically tag all files when reading in
  1405.                   a new subdirectory
  1406.  
  1407.             On  - DISKFILL will automatically tag all files when reading in a
  1408.                   new subdirectory, as offloading all files is the most common
  1409.                   operation to perform.
  1410.  
  1411.             Command line parameter:  /NOTAGALL     (In DISKFILL Only)
  1412.  
  1413.               Turns the above feature off.
  1414.  
  1415.  
  1416.         30) DISKFILL Sort Order
  1417.  
  1418.             Setting         Description                           Parameter
  1419.  
  1420.             None            Show file list in the order of
  1421.                             appearance in the DOS directory.
  1422.  
  1423.             Filename        Show file list with subdirectories       /SF
  1424.                             at the top, followed by the files in
  1425.                             ascending order by filename.
  1426.  
  1427.             File Extension  Show file list with subdirectories       /SE
  1428.                             at the top, followed by the files in
  1429.                             ascending order by file extension.
  1430.  
  1431.             File Size       Show file list with subdirectories       /SS
  1432.                             at the top, followed by the files in
  1433.                             ascending order by file size.
  1434.  
  1435.             File Date/Time  Show file list with subdirectories       /SD
  1436.                             at the top, followed by the files in
  1437.                             ascending order by file date/time.
  1438.  
  1439.  
  1440.       
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1450.  
  1451.                                       Page 21
  1452.  
  1453.  
  1454.  
  1455.           31) DISKFILL Reverse Sort
  1456.  
  1457.             No  - If a sorting order (above) is specified, the list will be
  1458.                   sorted in ascending order.
  1459.  
  1460.             Yes - If a sorting option above is specified, the sort will be in
  1461.                   descending order instead of the normal order.
  1462.  
  1463.             Command line parameter:  /RS
  1464.  
  1465.               Turns the above feature on.
  1466.  
  1467.  
  1468.         32) DISKFILL/DUPCLEAN Uses CATDISK
  1469.  
  1470.             Standard Version            - When DISKFILL finishes copying or
  1471.                                           moving files to the target floppy
  1472.                                           disk, it will, if requested, load
  1473.                                           the standard version of CATDISK
  1474.                                           (CATDISK.EXE) to automatically
  1475.                                           catalog the target floppy disk.
  1476.                                           Control then returns to DISKFILL
  1477.                                           when the task is completed.
  1478.                                           Likewise, DUPCLEAN, after erasing
  1479.                                           files from a floppy disk will perform
  1480.                                           the same type of function.
  1481.  
  1482.             DPMI Protected Mode Version - DISKFILL and DUPCLEAN will load the
  1483.                                           DPMI protected mode version of
  1484.                                           CATDISK, CATDISKD.EXE instead of the
  1485.                                           standard one.  Use this option if the
  1486.                                           catalog file being used exceeds the
  1487.                                           capacity of the standard version of
  1488.                                           CATDISK.
  1489.  
  1490.             Command Line Option:  /CATDISKD   (In DISKFILL and DUPCLEAN Only)
  1491.  
  1492.               Activates the DPMI option above.
  1493.       
  1494.     
  1495.         33) DUPCLEAN Uses Versions
  1496.  
  1497.             Off - DUPCLEAN will not pay attention to any characters after the
  1498.                   base characters as per the setting in the program.  See the
  1499.                   appendix covering DUPCLEAN for further details.
  1500.  
  1501.             On -  Specifies that characters after base characters used must be
  1502.                   numeric.  This is handy to limit the list to older versions
  1503.                   of the same program.
  1504.  
  1505.             Command Line Option: /VERSIONS         (In DUPCLEAN Only)
  1506.  
  1507.               Turns the above feature on.
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1516.  
  1517.                                       Page 22
  1518.  
  1519.  
  1520.  
  1521.         34) High ASCII On Screen
  1522.  
  1523.             Off - All programs will use a series of dashes (-), or-bars (|) and
  1524.                   pluses (+) to assimilate the IBM upper ASCII line graphic
  1525.                   characters in the screen displays.  This is useful on some
  1526.                   systems (eg. those supporting oriental languages) where
  1527.                   foreign character sets have been substituted for the line
  1528.                   graphic characters.  In this case, CATDISK's screen displays,
  1529.                   particularly the borders may look strange unless this feature
  1530.                   is turned off.
  1531.  
  1532.             On  - All programs will use the upper ASCII line graphic characters
  1533.                   on screen displays.
  1534.  
  1535.             Command Line Option: /NOHIGH
  1536.  
  1537.               Turns the above feature off.
  1538.     
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1582.  
  1583.                                       Page 23
  1584.  
  1585.  
  1586.  
  1587.         LIMITING WHICH DISKS DISKFILL RECOMMENDS FOR BACKFILLING
  1588.  
  1589.         The Optimal Disk Fill utility, DISKFILL, has a feature while filling
  1590.         disks with files whereby, at the disk change prompt, it can recommend
  1591.         disks already cataloged that have sufficient free space on them to
  1592.         accommodate one or more of the files from the list of files to be
  1593.         offloaded.  We refer to this process as backfilling.
  1594.  
  1595.         Normally, DISKFILL will base select its recommendations from ALL
  1596.         entries in the currently loaded catalog summary.  There may be times,
  1597.         however, when you have certain disks in your catalog to which you do
  1598.         not wish to add files (such as commercial distribution disks), or for
  1599.         that matter, disks to which you cannot add files (such as CD-ROM
  1600.         disks).
  1601.  
  1602.         By pressing <F5>, you will bring up a list of 20 "volumespecs" that
  1603.         DISKFILL will exclude from the list of disks to be recommended.  These
  1604.         entries may follow CATDISK's wildcard matching conventions.  Any disk
  1605.         matching one of these "volumespecs" will be excluded from the list of
  1606.         disks that might be recommended for backfilling operations.
  1607.  
  1608.         Because of the fact that this list is limited to 20 specifications, you
  1609.         might want to have all of your commercial disks and CD-ROMS labeled in
  1610.         a similar manner.  If they already have volume labels on them, use
  1611.         CATDISK's "ALIAS" feature to override the volume label without writing
  1612.         a new volume label on the disk.  This way, you can stretch the list out
  1613.         further and cover more disks this way.
  1614.  
  1615.         Moving around this screen and changing the entries is simple:
  1616.  
  1617.         To change a volumespec, simply use the cursor keys to move to the
  1618.         desired filespec and type in the new information for that area.  To
  1619.         clear out an existing spec, just fill the area with spaces.
  1620.  
  1621.         When you are finished modifying the list, press <Esc> to return to the
  1622.         main configuration screen.  Any changes made to the list will be saved
  1623.         when you press <F10> to save the entire configuration.
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1648.  
  1649.                                       Page 24
  1650.  
  1651.  
  1652.  
  1653.         LIMITING WHICH FILES GET CATALOGED
  1654.  
  1655.         There are certain circumstances where it is desirable to set
  1656.         limitations on which files get cataloged and which ones do not.   For
  1657.         example, you may only want CATDISK to catalog program files (.EXE,
  1658.         .COM, .SYS or .BAT) and archives (i.e. .ZIP, .ARJ, .LZH, etc.).
  1659.  
  1660.         Likewise, you may have many bootable system disks in your collection
  1661.         that contain the files IO.SYS, MSDOS.SYS and COMMAND.COM which you do
  1662.         not want listed many times in your catalog file. We provide two
  1663.         complimentary functions that can be controlled from  within the
  1664.         configuration utility, a screen containing "file include" specs and
  1665.         "file exclude" specs.  Each screen contains 20 spaces in which you can
  1666.         place wildcard filespecs (CATDISK's extended wildcard specifications
  1667.         are valid here as well) that CATDISK will use to determine whether or
  1668.         not a given file being scanned will be included in your catalog file.
  1669.  
  1670.         <F6> will bring up the "file include" specs.  By default, the list is
  1671.         blank, which indicates to CATDISK that all files (*.*) will be included
  1672.         in any cataloging operations unless a given file matches one of the
  1673.         specifications in the "file exclude" list, discussed later.  These
  1674.         wildcard specifications may follow the extended pattern matching that
  1675.         CATDISK supports.
  1676.  
  1677.         <F7> bring up a list of up to 20 wildcard specifications for files that
  1678.         you do not want included in cataloging operations.  When CATDISK scans
  1679.         a disk to be cataloged, any files matching one of the specifications in
  1680.         the list will be ignored.
  1681.  
  1682.         One thing to note, though.  If you instruct CATDISK to skip archive
  1683.         files, the directory information of those archives will still be
  1684.         examined and included in the cataloging operation if appropriate.
  1685.  
  1686.         Both of these screens operate in the same manner.
  1687.  
  1688.         To change a filespec, simply use the cursor keys to move to the desired
  1689.         filespec and type in the new information for that area.  To clear out
  1690.         an existing spec, just fill the area with spaces.
  1691.  
  1692.         When you are finished modifying the list, press <Esc> to return to the
  1693.         main configuration screen.
  1694.  
  1695.         The range of functionality of these two screens combined can be quite
  1696.         flexible.  For example, using the scenario above, you might want to
  1697.         catalog program files (.COM, .EXE, .SYS, .BAT) and archive files (.ZIP,
  1698.         .ARJ, .LZH, .ARC) but do not want files such as COMMAND.COM, IO.SYS,
  1699.         MSDOS.SYS, CONFIG.SYS and AUTOEXEC.BAT included in the catalog.
  1700.  
  1701.         You would set up the two lists as follows (listed side by side here to
  1702.         conserve space):
  1703.  
  1704.         Include Filespec  1  *.COM           Exclude Filespec  1  COMMAND.COM
  1705.         Include Filespec  2  *.EXE           Exclude Filespec  2  IO.SYS
  1706.         Include Filespec  3  *.SYS           Exclude Filespec  3  MSDOS.SYS
  1707.         Include Filespec  4  *.BAT           Exclude Filespec  4  CONFIG.SYS
  1708.         Include Filespec  5  *.ZIP           Exclude Filespec  5  AUTOEXEC.BAT
  1709.         Include Filespec  6  *.ARJ
  1710.         Include Filespec  7  *.LZH
  1711.         Include Filespec  8  *.ARC
  1712.  
  1713.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1714.  
  1715.                                       Page 25
  1716.  
  1717.  
  1718.  
  1719.         RECALLING A PREVIOUS CONFIGURATION
  1720.  
  1721.         If you were using CATDISK v3.61 or later, you can quickly recall any
  1722.         configuration information that you had stored in that release.  This
  1723.         can save you some time in setting the program up for your preferences,
  1724.         particularly if you've customized all the screen colors.  Before
  1725.         copying the new program files to your work disk, you might want to
  1726.         rename the executable file from the previous installation (CATDISK.COM
  1727.         in older releases or CATDISK.EXE in more recent versions) to another
  1728.         name.
  1729.  
  1730.         Example - Upgrading from V4.50 to this release:
  1731.  
  1732.         Procedure:
  1733.  
  1734.           1) Rename your old CATDISK.EXE to CAT450.EXE (this file holds the
  1735.              configuration information from the last installation.
  1736.  
  1737.           2)  Run the configuration utility, CDISKCFG.EXE.
  1738.  
  1739.           3)  Hit <F8>.  CDISKCFG will ask you for the file name of the old
  1740.               program file.  Answer "CAT450.EXE" (without the quotes).
  1741.               CDISKCFG will search the given file for the appropriate
  1742.               configuration information.  If successful, this information will
  1743.               be reflected in the configuration options as displayed on the
  1744.               screen.  If you've selected the wrong file, you will get an error
  1745.               message, and the old settings will remain intact on the screen.
  1746.  
  1747.           4)  If successful, press <F10>, and the settings will be saved in
  1748.               the current CATDISK release.
  1749.  
  1750.           5)  Delete CAT450.EXE - it's no longer needed.
  1751.  
  1752.         COLOR CUSTOMIZATION
  1753.  
  1754.         If you would prefer a color scheme other than the default ones supplied
  1755.         with CATDISK, you may set your own from within the configuration
  1756.         program.  To do so, simply hit <F9> from the configuration screen and
  1757.         follow the menus.  Once you have selected this option, you will see a
  1758.         menu that will allow you to select some general colors such as screen
  1759.         background and border color (CGA type displays only - EGA and VGA have
  1760.         no effect), as well as an option to reset the author's (that's me!)
  1761.         colors should you really make a mess of the color scheme and wish to
  1762.         start over.
  1763.  
  1764.         The other options will bring up menus that pertain to the various
  1765.         screens that you might encounter in your usage of CATDISK.  When you
  1766.         reach these, there will be an option available for each item that will
  1767.         change its foreground or background color.  Selecting an option will
  1768.         step you through the possible color range for that particular item.
  1769.  
  1770.         On monochrome or black & white systems, you may have to press an option
  1771.         key several times to cycle through the available colors, as many of
  1772.         these colors may appear the same on these systems.
  1773.  
  1774.         Does this sound confusing?  Try it for yourself... it's really quite
  1775.         easy.  For starters, try setting everything to green on cyan <grin> (if
  1776.         you don't have a strong stomach, don't bother).
  1777.  
  1778.  
  1779.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1780.  
  1781.                                       Page 26
  1782.  
  1783.  
  1784.  
  1785.         SAVING YOUR CONFIGURATION
  1786.  
  1787.         Once you have set all the fields to your desired settings, you may
  1788.         instruct CDISKCFG to save the current settings by pressing <F10>.
  1789.         CATDISK will save the appropriate information in the CATDISK.EXE and
  1790.         CATLOOK.EXE program files and return to DOS.
  1791.  
  1792.         If you do not wish to save the changes you made, simply hit <Esc>, and
  1793.         you will be returned to DOS, while the previous configuration will
  1794.         remain unscathed.
  1795.  
  1796.  
  1797.         DEFAULT SETTINGS
  1798.  
  1799.         CATDISK is shipped with the following default settings:
  1800.  
  1801.         1) Screen Update Method:              BIOS
  1802.         2) Color or B & W:                    B & W
  1803.         3) Output Lines Per Page:             58
  1804.         4) Printer Startup String:            Nothing
  1805.         5) Printer Finishing String:          Nothing
  1806.         6) Default ARCHIVE Extract State:     ON
  1807.         7) Catalog Drive:                     A:
  1808.         8) Catalog File Directory:            Default Drive and Directory
  1809.         9) Maximum Disks/Files per Catalog:   1000/16384
  1810.  
  1811.         10) Color Scheme:                     Authors Colors
  1812.  
  1813.  
  1814.         GENERAL CONSIDERATIONS WHEN CONFIGURING CATDISK
  1815.  
  1816.         When setting CATDISK up, there are a few things you should consider:
  1817.  
  1818.         If you have a hard disk, you should use it for maintaining your catalog
  1819.         files (i.e. set your catalog file directory to somewhere on your hard
  1820.         drive).
  1821.  
  1822.         If possible, set your video update method to DIRECT.  CATDISK runs
  1823.         faster in this mode.
  1824.  
  1825.         When setting your printer up for printing reports, try to set the
  1826.         printer startup string such that the complete catalog listing (i.e.
  1827.         files, stats and comments) can be printed.
  1828.  
  1829.         The best setting for the default ARCHIVE extract state is QUERY.  Many
  1830.         archives do not need to be fully extracted as the name of the archive
  1831.         filename itself is all that is necessary in order to identify what is
  1832.         on that particular disk.  By using some discretion in deciding which
  1833.         archive files need be extracted, you can dramatically reduce the size
  1834.         of your catalog files (as well as the time needed to update and search
  1835.         them).  Some however, need to be extracted (for example, MISC.ARC).
  1836.         This setting gives you the best of both worlds.
  1837.  
  1838.         When setting the default drive and directory for your catalog files, be
  1839.         sure and include it in your DOS PATH as well.  Although this is not
  1840.         necessary, it will enable you to run CATDISK from anywhere in your
  1841.         system without having to change to that directory before running
  1842.         CATDISK.  Setting the PATH for this is only beneficial to those using
  1843.         hard drives.
  1844.  
  1845.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1846.  
  1847.                                       Page 27
  1848.  
  1849.  
  1850.  
  1851.         When setting the maximum number of disks and files that can be
  1852.         maintained in a catalog file, the best setting should be the LOWEST one
  1853.         that will contain your largest catalog file.  This will maximize the
  1854.         amount of free memory left over that CATDISK can use to store file
  1855.         information being read from disks being cataloged, sorting information,
  1856.         caching information, and the like.
  1857.  
  1858.         Keep in mind that, if you should have a catalog file grow to your set
  1859.         maximum, you can always re-configure CATDISK (memory permitting, of
  1860.         course) to accommodate a larger configuration, unless you are already
  1861.         at the highest setting.  When you next run CATDISK after making these
  1862.         changes, your catalog file will then be able to grow to the new
  1863.         setting.
  1864.  
  1865.         If you are running on floppy drives, use setting #4 for the maximum
  1866.         catalog size (512 disks/8192 files per catalog).  Your files will never
  1867.         exceed this limitation.
  1868.  
  1869.  
  1870.         SAMPLE CONFIGURATIONS
  1871.  
  1872.         Scenario:  One Hard Disk (C:) and a floppy drive:
  1873.  
  1874.                    Make a directory "C:\CATDISK" and copy the files CATDISK.EXE
  1875.                    and CDISKCFG.EXE to it.  Set the configuration to:
  1876.  
  1877.                     1) Screen Update Method:              <your option>
  1878.                     2) Color or B & W:                    <your option>
  1879.                     3) Output Lines Per Page:             <your option>
  1880.                     4) Printer Startup String:            <your option>
  1881.                     5) Printer Finishing String:          <your option>
  1882.                     6) Default ARCHIVE Extract State:     <your option>
  1883.                     7) Catalog Drive:                     A:
  1884.                     8) Catalog File Directory:            C:\CATDISK
  1885.                     9) Maximum Disks/Files per Catalog:   <your option>
  1886.     
  1887.                    Add C:\CATDISK to the DOS PATH and you will be able to call
  1888.                    up CATDISK or CATLOOK from anywhere in your system.
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1912.  
  1913.                                       Page 28
  1914.  
  1915.  
  1916.  
  1917.         Scenario:  Two floppy drives:
  1918.  
  1919.                    Take a blank disk and copy the files CATDISK.EXE and
  1920.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  1921.                    Set the configuration to:
  1922.  
  1923.                    1)  Screen Update Method:              <your option>
  1924.                    2)  Color or B & W:                    <your option>
  1925.                    3)  Output Lines Per Page:             <your option>
  1926.                    4)  Printer Startup String:            <your option>
  1927.                    5)  Printer Finishing String:          <your option>
  1928.                    6)  Default ARCHIVE Extract State:     <your option>
  1929.                    7)  Catalog Drive:                     A:
  1930.                    8)  Catalog File Directory:            B:\
  1931.                    9)  Maximum Disks/Files per Catalog:   500/8192
  1932.  
  1933.                    When starting CATDISK from DOS, insert the program disk in
  1934.                    drive A: and take a blank formatted disk and insert it in
  1935.                    drive B:.  This will be your data disk.  When CATDISK has
  1936.                    loaded and has displayed the title screen, you may remove
  1937.                    the CATDISK program disk from the A: drive.  This will now
  1938.                    be the drive from which disks being cataloged will be read.
  1939.  
  1940.         Scenario:  One floppy drive:
  1941.  
  1942.                    Take a blank disk and copy the files CATDISK.EXE and
  1943.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  1944.                    Set the configuration to:
  1945.  
  1946.                    1)  Screen Update Method:              <your option>
  1947.                    2)  Color or B & W:                    <your option>
  1948.                    3)  Output Lines Per Page:             <your option>
  1949.                    4)  Printer Startup String:            <your option>
  1950.                    5)  Printer Finishing String:          <your option>
  1951.                    6)  Default ARCHIVE Extract State:     <your option>
  1952.                    7)  Catalog Drive:                     A:
  1953.                    8)  Catalog File Directory:            A:\
  1954.                    9)  Maximum Disks/Files per Catalog:   500/8192
  1955.  
  1956.                    When starting CATDISK for the first time, insert the
  1957.                    program disk in drive A: and start CATDISK. You will need to
  1958.                    add the command line option /IP (initial pause - see later
  1959.                    in this manual).
  1960.  
  1961.                    Once CATDISK has loaded, it will pause and ask you to insert
  1962.                    your data disk.  If this is the first time you are running
  1963.                    CATDISK, use a blank formatted disk.
  1964.                    When you catalog a disk, you must first remove the data disk
  1965.                    and insert the disk to be cataloged BEFORE activating the
  1966.                    catalog function.  When CATDISK is done reading the disk, it
  1967.                    will ask you to re-insert the data disk.
  1968.  
  1969.         IMPORTANT NOTE
  1970.  
  1971.         If you are running CATDISK on a single drive system, I would recommend
  1972.         the above configuration for the reason that, even though DOS can make
  1973.         the one drive act like A: and B:, this will allow CATDISK to prompt you
  1974.         for the appropriate disks, thus avoiding the DOS prompt "Insert disk
  1975.         for drive B:" and the like.
  1976.  
  1977.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  1978.  
  1979.                                       Page 29
  1980.  
  1981.  
  1982.  
  1983.         STARTING CATDISK
  1984.  
  1985.         CATDISK is started from the DOS command line by issuing the following:
  1986.  
  1987.         CATDISK parameters
  1988.  
  1989.         - where parameters may include any of the command line options from the
  1990.           section "Configuring CATDISK" or any of the following options covered
  1991.           here:
  1992.  
  1993.              /D:        - Catalog files from drive D: where D: is one of
  1994.                           [A - {last drive in your system}].
  1995.  
  1996.              /CATALOG   - If this option is added to your command line, CATDISK
  1997.                           will perform a catalog operation on the catalog drive
  1998.                           (the setting from the CDISKCFG program may be
  1999.                           overridden on the command line) and return to DOS
  2000.                           when done.  If you have the autocomments feature in
  2001.                           CATDISK turned on, you will be taken to the comment
  2002.                           entry screen first.  When you exit from this screen,
  2003.                           you will then be returned to DOS.
  2004.  
  2005.                           This option makes it possible to catalog a disk from
  2006.                           a batch file, or from within another application by
  2007.                           shelling out to CATDISK with the correct parameters.
  2008.                           When CATDISK exits, you will be returned to your
  2009.                           application.
  2010.  
  2011.                           NOTE:  It is not advisable to put this option in the
  2012.                           CATDISK environment variable, discussed below, as it
  2013.                           will make it impossible to get into CATDISK's other
  2014.                           functions.
  2015.  
  2016.              /?         - Display a terse list of available command line
  2017.                           options.
  2018.  
  2019.  
  2020.         The slash "/" may be substituted by either a dash "-" or a space " ".
  2021.  
  2022.         Examples:  CATDISK /FGAMES/NS/AC/CO/P3/R5/ALIAS/B:   or  CATDISK A:
  2023.  
  2024.  
  2025.         IF CATDISK/D CANNOT RECOGNIZE YOUR HARDWARE
  2026.  
  2027.         If you are using a memory manager that provides DPMI services, such as
  2028.         386MAX or QEMM, CATDISK/D will automatically detect it and use it.  If
  2029.         not, CATDISK/D will load Borland International's DPMI handler
  2030.         automatically. If you get a message that your hardware is not
  2031.         recognized by the DPMI handler, you will need to run a DPMI
  2032.         installation program called DPMIINST.EXE, which will examine your
  2033.         hardware to best determine how to access it.
  2034.  
  2035.         There are no options necessary when running the installation program,
  2036.         just type "DPMIINST" from within the CATDISK directory and make sure
  2037.         that the file "DPMI16BI.OVL" is present.  Follow the prompts given to
  2038.         you by the DPMIINST program and when it finishes its operation, you
  2039.         will be ready to use CATDISK/D normally as you would use CATDISK
  2040.         itself.
  2041.  
  2042.  
  2043.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2044.  
  2045.                                       Page 30
  2046.  
  2047.  
  2048.  
  2049.         SAVING PARAMETERS SO YOU DON'T HAVE TO TYPE THEM EACH TIME
  2050.  
  2051.         If you find yourself typing in the same set of command line parameters
  2052.         each time you start CATDISK, you can save yourself some time by putting
  2053.         the command line options in a CATDISK environment variable using the
  2054.         DOS "SET" command.  This command (see examples below), may be placed in
  2055.         your AUTOEXEC.BAT file so that you will not need to remember which
  2056.         command line options to use to obtain your favorite setup, or for that
  2057.         matter, to type them!
  2058.  
  2059.         - example:  SET CATDISK=/FGAMES/NS/AC/CO/P2/ALIAS/B:
  2060.  
  2061.         When you start CATDISK under these circumstances, simply type "CATDISK"
  2062.         <Enter> and the above options will automatically be invoked.
  2063.  
  2064.         Any options entered on the command line will be added to those
  2065.         specified in the CATDISK environment variable.  This makes it possible
  2066.         to have a base set of options set in the DOS environment and have an
  2067.         optional set that you can specify at the time you run CATDISK.
  2068.  
  2069.         It is also possible to override some of the options as well (for
  2070.         example, the printed report format, the screen report format, the
  2071.         catalog file, and the catalog drive), as CATDISK will pay attention to
  2072.         the last option of a given type.
  2073.  
  2074.         For example, using the above environment example, entering the command
  2075.  
  2076.         CATDISK /A:/P1
  2077.  
  2078.         will cause CATDISK to set the catalog drive to A: (overrides the B:
  2079.         option), and the printer report format to show comments (format #1)
  2080.         instead of statistics and comments (format #2).
  2081.  
  2082.         Once CATDISK has been successfully started, a title screen will appear.
  2083.         Hit any key to proceed to the main menu.
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2110.  
  2111.                                       Page 31
  2112.  
  2113.  
  2114.  
  2115.                              3.  U S I N G   C A T D I S K
  2116.  
  2117.         USING THE MENUS
  2118.  
  2119.         The major options available from CATDISK such as the main functions
  2120.         that you see in the opening menu after the title page disappears can be
  2121.         selected in two different ways.
  2122.  
  2123.         The first, and easiest is just to hit the indicated key beside the
  2124.         desired option.
  2125.  
  2126.         In response to a requests from registered users, we have also
  2127.         implemented a "point and shoot" method of selecting items from a menu.
  2128.  
  2129.         Simply use the cursor keys to position the flashing arrows in the
  2130.         inverse box that indicates the keystroke required to activate the
  2131.         desired option and hit <Return> or <Enter>.  This will carry out the
  2132.         same function as if you had struck the key in the inverse box.
  2133.  
  2134.         One advantage that the second approach has to the first is that those
  2135.         of you who do not touch type numbers very well (or have a tendency to
  2136.         hit the key beside the one you are after) have another method to use to
  2137.         navigate through the menus of CATDISK.
  2138.  
  2139.         Another is that once you have activated a function such as cataloging a
  2140.         disk, you need only type <Return> to re-activate that function as
  2141.         CATDISK will remember the last option you activated (quite handy if you
  2142.         are cataloging multiple disks, as the <Return> key is larger than
  2143.         most... you aren't as apt to miss it).
  2144.  
  2145.         The menus in CATDISK currently consist of a main menu controlling the
  2146.         main functions of catalog maintenance, a settings & toggles menu
  2147.         containing functions that affect how CATDISK responds to certain
  2148.         situations, and a reports & inquiries menu from which all reports are
  2149.         accessed.
  2150.  
  2151.         Normally, to access the options available in the Settings & Toggles
  2152.         Menu, you have to go to that menu of options from the main menu in
  2153.         order to change any of the settings.  We have provided shortcuts to the
  2154.         options in the Settings & Toggles Menus that are accessible from both
  2155.         the Main Menu and from the Reports & Inquiries Menu.
  2156.  
  2157.         To change any of the settings available in the settings and toggles
  2158.         menu directly from the either the main menu or the reports & inquiries
  2159.         menu, simply hold down the <Alt> key and press the number key (from the
  2160.         top row only, not the numeric keypad) or function key that you would
  2161.         normally hit if you were in the settings and toggles menu.  CATDISK
  2162.         will act on that keystroke as if you had selected that option directly
  2163.         from the settings and toggles appropriate menu.
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2176.  
  2177.                                       Page 32
  2178.  
  2179.  
  2180.  
  2181.         SELECTING A VOLUME NAME FROM A LIST
  2182.  
  2183.         Other than actually labeling a disk, there are three other locations in
  2184.         CATDISK where you will be prompted for a volume label: un-cataloging a
  2185.         disk; generating a report by volume id; and adding file comments by
  2186.         volume.  If you know what volume label is desired at the prompt, you
  2187.         may enter it verbatim.  Leaving it blank, however, will cause CATDISK
  2188.         to come up with a point-and-shoot list of all the volume names in the
  2189.         current catalog file.  When this list first appears, you will notice
  2190.         that the first volume is highlighted.  Selecting a volume from this
  2191.         list is merely a matter of moving the highlight bar to the desired
  2192.         volume and pressing <Enter>.
  2193.  
  2194.         The following options are available:
  2195.  
  2196.           <Cursor UP>   - move up one line in the list.  If you are already at
  2197.                           the top of a column, the highlight bar will move to
  2198.                           the bottom of the previous column if available.
  2199.  
  2200.           <Cursor DOWN> - move down one line in the list.  If you are already
  2201.                           at the bottom of a column, the highlight bar will
  2202.                           move to the top of the next column if available.
  2203.  
  2204.           <PgUp>        - move back 96 lines in the list.
  2205.           <PgDn>        - move ahead 96 lines in the list.
  2206.  
  2207.           <Home>        - move to the beginning of the list.
  2208.  
  2209.           <End>         - move to the end of the list.
  2210.  
  2211.           <Grey Plus>   - move forward in the list 1/15th of the total length
  2212.                           of the list (see the appendix regarding the SCROLL
  2213.                           BAR later in this manual).
  2214.  
  2215.           <Grey Minus>  - move back in the list 1/15th of the total length of
  2216.                           the list (see the appendix regarding the SCROLL BAR
  2217.                           later in this manual).
  2218.  
  2219.           <Enter>       - Select the highlighted volume for the prompt from the
  2220.                           previous screen.
  2221.  
  2222.           <Esc>         - return to the menu with no further action taken.
  2223.  
  2224.  
  2225.         To jump quickly to an approximate location in the list, press any
  2226.         letter, number or punctuation key (except PLUS and MINUS, as they are
  2227.         already being used elsewhere).  You will be quickly moved to the first
  2228.         item in the list that starts with that character.  If nothing in the
  2229.         list starts with the character that you press, a short beep will sound.
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2242.  
  2243.                                       Page 33
  2244.  
  2245.  
  2246.  
  2247.         OPTION 1 - SET DRIVE FOR CATALOGING
  2248.  
  2249.         This function allows you to set the drive from which the files to be
  2250.         cataloged will be read.  Simply select letter from (A - x) to select
  2251.         the drive with that DOS letter designation, where x is the last drive
  2252.         that CATDISK detected in your system configuration.  The change will be
  2253.         noted immediately in the status area at the top of the screen.
  2254.  
  2255.         *** NOTE:  If you are running with one floppy drive only and have
  2256.                    turned the caching option on from the configuration utility,
  2257.                    do not set this option to a drive other than the one on
  2258.                    which the catalog files reside (probably A:).  Failure to do
  2259.                    so could cause loss of data on your disks.
  2260.                    See the SAMPLE CONFIGURATIONS section covered earlier in
  2261.                    this section.  You have been warned!
  2262.  
  2263.         Users with a hard-disk, single floppy configuration, who are running
  2264.         CATDISK from the hard disk will NOT experience this problem and may
  2265.         proceed as normal.  It's ONLY if the same PHYSICAL drive is being used
  2266.         for the CATDISK work files AND the disk to be cataloged that the
  2267.         above precautions must be taken.
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2308.  
  2309.                                       Page 34
  2310.  
  2311.  
  2312.  
  2313.         OPTION 2:  SETTINGS AND TOGGLES MENU
  2314.  
  2315.         The options available in this sub-menu will allow you to control the
  2316.         behavior of some of the features of CATDISK.  You can get to this menu
  2317.         by selecting option #2 from the main menu.
  2318.  
  2319.         The options available on this menu are:
  2320.  
  2321.  
  2322.         Sub-option 1 - Set Current Catalog File
  2323.         ---------------------------------------
  2324.  
  2325.         Although the catalog filename may be set upon starting up CATDISK, it
  2326.         may also be convenient to be able to change the current file from
  2327.         within a CATDISK session.  Select option #3 from the main menu, and you
  2328.         will be prompted for a new catalog file to use.  Any valid DOS filename
  2329.         will do.  Be sure to specify the NAME portion only; do not include the
  2330.         file extension portion.  If the name you specify is valid, it will then
  2331.         be used for all subsequent catalog updates and queries (This is
  2332.         reflected at the top of the screen).  If not, an error message will be
  2333.         issued and no change will be made to the current catalog file name.
  2334.  
  2335.         If the catalog file set that you specify does not exist, CATDISK will
  2336.         automatically create a new catalog for you.  Before doing so, however,
  2337.         CATDISK will indicate that the summary or catalog file does not exist
  2338.         and request your permission to create it before proceeding.  If you
  2339.         specified /NW on the command line, this warning will not appear -
  2340.         CATDISK will simply proceed to create any necessary files for the
  2341.         specified catalog set.
  2342.  
  2343.         If you don't enter anything for the catalog filename, a list of all
  2344.         current catalog files in the catalog directory will be displayed on the
  2345.         screen.  If the desired catalog is on a removable disk (i.e. floppy
  2346.         disks or removable hard drives), be sure and have that disk in the
  2347.         appropriate drive BEFORE you enter nothing to the prompt so the desired
  2348.         files will appear in the list.  This method can be handy when you are
  2349.         not sure of exactly what you called a particular catalog file.
  2350.  
  2351.         To select a file from the list, simply move the highlight bar around
  2352.         the list of filenames with the cursor keys so that it rests on the
  2353.         desired catalog file.  At this point, hit the <Enter> key, and that
  2354.         file will be selected as if you had typed it at the prompt.  Hitting
  2355.         <Esc> in this screen will abort the operation as if you had pressed
  2356.         <Esc> at the prompt.
  2357.  
  2358.         If you are switching to a catalog that already exists, and it will not
  2359.         fit into the configuration you defined in the configuration program
  2360.         (maximum disks/files per catalog), you will get an error message and
  2361.         the catalog file setting will be left unchanged.
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2374.  
  2375.                                       Page 35
  2376.  
  2377.  
  2378.  
  2379.         Sub-option 2 - Pauses On/Off
  2380.         ----------------------------
  2381.  
  2382.         Under normal circumstances, CATDISK will pause at strategic places,
  2383.         either to allow you to view what has just happened (cataloging and
  2384.         un-cataloging), or to prompt you to insert a disk in drive X:
  2385.         (labeling or reading directories, etc).  If you turn this toggle off,
  2386.         CATDISK will only prompt you for a disk when absolutely necessary.  In
  2387.         addition, there will be no pause at the end of a catalog update; you
  2388.         will immediately be returned to the main menu, or to the comment entry
  2389.         screen if you have the AUTO COMMENT feature turned on.
  2390.  
  2391.  
  2392.         Sub-option 3 - Change Printer Report Type
  2393.         -----------------------------------------
  2394.  
  2395.         CATDISK currently supports three printer report styles, which are
  2396.         detailed here.  The particular report style that you desire may be set
  2397.  
  2398.         with this toggle, and will be reflected in the toggles portion of the
  2399.         menu screen.
  2400.  
  2401.         STATISTICS:  This is the default report style (unless overridden on the
  2402.                      command line), which is to show the path, filename, volume
  2403.                      id, archive id, as well as the size, date, time and DOS
  2404.                      directory attributes of each file listed.  The summary
  2405.                      report will be printed with all information EXCEPT
  2406.                      comments.
  2407.  
  2408.                      This report style corresponds to the command line option
  2409.                      /P0, and will fit on an 80 column printer.
  2410.  
  2411.           COMMENTS:  This report style will show the filename, volume id,
  2412.                      archive id and full comment for each file listed.  The
  2413.                      summary report will print with Volume ID, Disk Capacity,
  2414.                      Free Disk Space and Comment.
  2415.  
  2416.                      This report style corresponds to the command line option
  2417.                      /P1, and will fit on an 80 column printer.
  2418.  
  2419.           SUBDIRS:   This report style will show the subdirectory, filename,
  2420.                      volume id, archive id and a shortened comment for each
  2421.                      file listed.  The summary report will print with Volume
  2422.                      ID, Disk Capacity, Free Disk Space and Comment.
  2423.  
  2424.                      This report style corresponds to the command line option
  2425.                      /P1, and will fit on an 80 column printer.
  2426.  
  2427.           ALL INFO:  This report style will show all of the fields from the
  2428.                      catalog file or the summary file (depending on your choice
  2429.                      of report).  Please note that it assumes that you
  2430.                      either have a 132 column printer, or an 80 column printer
  2431.                      set to compressed mode.  It corresponds to the command
  2432.                      line option /P3.
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2440.  
  2441.                                       Page 36
  2442.  
  2443.  
  2444.  
  2445.         Sub-option 4 - Report Totals On/Off
  2446.         -----------------------------------
  2447.  
  2448.         When this setting is turned ON, CATDISK will display a line at the
  2449.         bottom of the screen-based reports showing the totals for the given
  2450.         report showing on the screen.  In printed or disk-based reports, these
  2451.         totals will be shown at the end of a report.
  2452.  
  2453.         One consideration in paginated reports... if your last report page is
  2454.         quite full, there is a possibility that the total line may "bleed" over
  2455.         to the next page on your printer.
  2456.  
  2457.         The presence of a "/T" beside the printer report type in the status
  2458.         area of CATDISK's main screen indicates that this feature is currently
  2459.         turned on.
  2460.  
  2461.  
  2462.         Sub-option 5 - File Comments On The Fly
  2463.         ---------------------------------------
  2464.  
  2465.         If this toggle is turned OFF, CATDISK will proceed back to the main
  2466.         menu upon completion of the process of cataloging a disk.  If you wish
  2467.         to add comments for some/all of the files that you have just
  2468.         cataloged, you may turn this toggle ON.  When this is the case,
  2469.         CATDISK will catalog files in the normal manner, but upon completion,
  2470.         you will be taken to another screen that will allow you to scroll
  2471.         through the files you just cataloged and add/update the comments for
  2472.         each file shown.  See Option F1 - Add/Change File Comments for details
  2473.         on how this section of the program works.
  2474.  
  2475.  
  2476.         Sub-option F1 - Main Archive Comment Copy
  2477.         -----------------------------------------
  2478.  
  2479.         If this feature is turned on, CATDISK will take special action when
  2480.         expanding ZIP and ARJ files.  If a main ZIP/ARJ file comment is found,
  2481.         any file entries extracted that do not have comments will have the main
  2482.         ZIP/ARJ file comment entry inserted instead.  The presence of a "C"
  2483.         beside the Auto Comments setting in the status information at the top
  2484.         of the screen indicates that this feature is turned on.
  2485.  
  2486.  
  2487.         Sub-option F2 - Extract 4DOS/NDOS Comments
  2488.         ------------------------------------------
  2489.  
  2490.         This setting controls whether or not CATDISK will process directory
  2491.         comments created by JP Software's 4DOS or Symantec Software's Norton
  2492.         DOS (NDOS).  If on, CATDISK, during a cataloging operation, will look
  2493.         for a hidden file in each subdirectory called "DESCRIPT.ION", which
  2494.         contains the text for these comments.  Where applicable, these comments
  2495.         will be included in your catalog file automatically.  If off, CATDISK
  2496.         will ignore these comments.  The presence of a "4" beside the Auto
  2497.         Comments setting in the status information at the top of the screen
  2498.         indicates that this feature is turned on.
  2499.  
  2500.         Although not tested, Norton DOS (NDOS) is largely based on JP
  2501.         Software's 4DOS program, and should work in a similar manner to that
  2502.         product.
  2503.  
  2504.  
  2505.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2506.  
  2507.                                       Page 37
  2508.  
  2509.  
  2510.  
  2511.         Sub-option 6 - Set Current Report Destination
  2512.         ----------------------------------------------
  2513.  
  2514.         Selecting this option will affect the report destination and whether or
  2515.         not CATDISK will ask you where the report should go.  Each time you
  2516.         select option 1, CATDISK will run through a sequence of five possible
  2517.         locations (SCRN (Screen), LPT1, LPT2, Disk, or ASK).
  2518.  
  2519.         Selecting one of the first four will cause CATDISK to immediately
  2520.         generate a report to the selected destination IMMEDIATELY upon
  2521.         selecting it.  You will not be prompted any further, unless you have
  2522.         selected DISK, in which case, you will be asked for a filename in which
  2523.         to place the report.
  2524.  
  2525.         If you select ASK, CATDISK will prompt you for a report location (one
  2526.         of the first four in the list) each time you ask it to generate a
  2527.         report.
  2528.  
  2529.         I usually leave this setting set to SCREEN as, most of the time, I
  2530.         browse through my catalog files on the screen.  You, however, may find
  2531.         it handy to set this to ASK, especially if you jump to report locations
  2532.         frequently.  If this is the case, you may, if you haven't already, add
  2533.         the command line option /ASK to your current list of options.  This
  2534.         will override the default location of SCREEN at startup, negating the
  2535.         need to set it manually each time you start CATDISK.
  2536.  
  2537.  
  2538.         Sub-option 7 - Print On Both Sides of Page
  2539.         ------------------------------------------
  2540.  
  2541.         Normally, CATDISK will print its hardcopy reports in a continuous
  2542.         stream to the printer.  By turning this feature on, CATDISK will print
  2543.         your reports in a format such that the odd numbered pages will be
  2544.         printed first.  CATDISK will then pause and ask you to re-insert the
  2545.         paper in your printer so that the even numbered pages will print on the
  2546.         back side of the odd numbered pages.  This will cut paper consumption
  2547.         on your reports in half.
  2548.  
  2549.         You will know when this feature is activated when you see a "/2" beside
  2550.         the report location in the information at the top of the screen.
  2551.  
  2552.         IMPORTANT NOTE:  Re-inserting paper previously printed on back into
  2553.                          some types of laser printers can cause damage to the
  2554.                          internal mechanisms of those printers.  Consult your
  2555.                          printer manual or check with the manufacturer before
  2556.                          using this option with your laser printer.
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2572.  
  2573.                                       Page 38
  2574.  
  2575.  
  2576.  
  2577.         Sub-option 8 - ARCHIVE Extract Setting
  2578.         --------------------------------------
  2579.  
  2580.         Although this setting is permanently set from the CDISKCFG utility, it
  2581.         is sometimes be convenient to be able to change it during a CATDISK
  2582.         session.  Selecting option 8 will run the Auto ARCHIVE Extract setting
  2583.         through three possibilities, OFF, ON, or QUERY.  The current setting is
  2584.         shown near the top of the screen in the status area.
  2585.  
  2586.         If this feature is turned OFF, any archive files encountered during the
  2587.         cataloging process will NOT be expanded.  Also, when generating
  2588.         reports, CATDISK will NOT include any files from the catalog in the
  2589.         report that are contained inside archive files, even though they may be
  2590.         present in the catalog itself (an archive may been expanded from a
  2591.         previous session where it was turned ON).
  2592.  
  2593.         If this feature is turned ON, CATDISK will extract the archive
  2594.         directory of any archive it encounters in its search.  Files contained
  2595.         in archives will be listed in any applicable reports.
  2596.  
  2597.         If it is set to QUERY, CATDISK will prompt you as to whether it should
  2598.         extract the archive directory of any archive that it encounters in its
  2599.         search before proceeding to do so.  Reports generated will act as if
  2600.         the feature is turned ON.
  2601.  
  2602.  
  2603.         Sub-option 9 - Comments When Archives Not Extracted
  2604.         ---------------------------------------------------
  2605.  
  2606.         In the course of its normal operation, CATDISK, when not extracting the
  2607.         directory information from ZIP or ARJ files, will search each one it
  2608.         encounters for the comment of the ZIP/ARJ file itself.  Under some
  2609.         circumstances, such as those where your particular collection of
  2610.         ZIP/ARJ files do not contain comments, or where the vast majority of
  2611.         them contain BBS advertisements (not really what they were intended
  2612.         for), this search can be both time consuming and meaningless.  This
  2613.         toggle will turn this feature on or off.  The presence of a "C" beside
  2614.         the Archive Extract setting in the status information at the top of the
  2615.         screen indicates that this feature is turned on.
  2616.  
  2617.         Although not related to ZIP/ARJ files, this feature will also control
  2618.         whether or not the graphic resolution and color information will be
  2619.         extracted from a GIF file to be included as the default comment for
  2620.         that particular file.
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2638.  
  2639.                                       Page 39
  2640.  
  2641.  
  2642.  
  2643.         Sub-option 0 - Aliases On/Off
  2644.         -----------------------------
  2645.  
  2646.         Activating this option will enable you to override the name under which
  2647.         a disk will be cataloged.  Normally, CATDISK will catalog a disk under
  2648.         the volume label.  This will allow you to optionally catalog the disk
  2649.         under a different name without changing the volume label on the disk
  2650.         being cataloged.
  2651.  
  2652.         Keep in mind that if you re-catalog the disk at a later time, you must
  2653.         remember the new name that you gave to the disk in your catalog,
  2654.         otherwise, duplication will occur in your catalog.
  2655.  
  2656.         The presence of a "ALS" beside the "VolLab:" setting in the status area
  2657.         of the screen indicates that this feature is turned on.
  2658.  
  2659.  
  2660.         Sub-option F3 - Suggest Volume Label On/Off
  2661.         -------------------------------------------
  2662.  
  2663.         With this setting turned ON, CATDISK will suggest a volume label to use
  2664.         when labeling a disk.  You may, of course, change that label at the
  2665.         prompt if you wish.  Depending on what has been done in CATDISK with
  2666.         regard to previous labeling operations, CATDISK will use the following
  2667.         criteria:
  2668.  
  2669.         1) If the disk already has a volume label, CATDISK will suggest that
  2670.            label.
  2671.  
  2672.         If the disk does not have a volume label:
  2673.  
  2674.         2) If you have previously labeled a disk during the current CATDISK
  2675.            session (i.e. you have not exited from the CATDISK program and have
  2676.            returned to it), CATDISK will examine the last entered volume label
  2677.            (entered at the prompt) to see if there is a numeric part of that
  2678.            volume label.  A numeric sequence is considered by CATDISK to be a
  2679.            series of two or more digits in a row.  That numeric part is then
  2680.            incremented by one and that new label becomes the suggested label.
  2681.  
  2682.            Examples:  DISK001   would become  DISK002
  2683.                       DISK001A  would become  DISK002A
  2684.  
  2685.            If two or more separate numerical sequences are present in the
  2686.            volume label, CATDISK will increment the rightmost one.
  2687.  
  2688.            Example:   A001B002 would become A001B003
  2689.  
  2690.            If there is no numerical part in the previous volume label, the
  2691.            volume label will be suggested verbatim.
  2692.  
  2693.         3) If you have not previously labeled a disk during the current CATDISK
  2694.            session, CATDISK will examine your summary file.  If you have
  2695.            previously cataloged disks with CATDISK, the last alphabetical entry
  2696.            in the summary file will be taken and treated as the suggestion in
  2697.            option 2.
  2698.  
  2699.         4) If you have not previously labeled a disk during the current CATDISK
  2700.            session and have not previously cataloged any disks with CATDISK,
  2701.            nothing will be suggested.
  2702.  
  2703.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2704.  
  2705.                                       Page 40
  2706.  
  2707.  
  2708.  
  2709.         If this feature is activated, you will see an "SV" to the right of the
  2710.         slash in the "VolLab:" section of the status area of the screen.
  2711.  
  2712.  
  2713.         Sub-option <Esc> - Exit To Main Menu
  2714.         ------------------------------------
  2715.  
  2716.         Exactly what it says.
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2770.  
  2771.                                       Page 41
  2772.  
  2773.  
  2774.  
  2775.         OPTION 3:  LABELING A DISK
  2776.  
  2777.         Selection of option #3 on the main menu will allow the VOLUME LABEL of
  2778.         a disk to be set or changed.  Upon selection, CATDISK will attempt to
  2779.         read the current label of the disk.  If none is present, you will be
  2780.         notified of this, and will be given the opportunity to create a volume
  2781.         label for that disk.  See the DOS manual on volume labels for more
  2782.         information.  If a label already exists on the disk, its name will be
  2783.         shown as a reminder, and you will be given an opportunity to change the
  2784.         label name.  Just enter the new label name and hit <CR>.
  2785.  
  2786.         Note that if you have the volume label suggestion facility turned on,
  2787.         CATDISK will recommend a sequential volume label for any new disks
  2788.         being labeled.  See the section of this manual dealing with "Suggest
  2789.         Volume Label" setting in the Settings & Toggles chapter for details on
  2790.         what CATDISK will recommend for a volume label under various
  2791.         circumstances.
  2792.  
  2793.         If the label name was valid, the change will be made, otherwise, an
  2794.         error message indicating such will be issued and you will return to the
  2795.         main menu.
  2796.  
  2797.         If you do not wish to enter or change the disk label, simply hit <ESC>
  2798.         at the volume label prompt and you will immediately return to the main
  2799.         menu with no changed made to the disk label.
  2800.  
  2801.         When the volume label has been successfully changed or created, CATDISK
  2802.         will check to see if the old label, if any was present, exists in the
  2803.         current catalog file.  If so, you will be given an opportunity to have
  2804.         CATDISK automatically change the old volume id references to the newly
  2805.         entered one.  If the disk that you re-labeled is one that actually is
  2806.         in the catalog, answer <Y>es to the prompt.  CATDISK will take care of
  2807.         the rest.  This feature can be a great time saver, as it eliminates the
  2808.         need to uncatalog the disk under the old volume id, and re-catalog it
  2809.         under the new name.
  2810.  
  2811.         If the disk is not in the catalog, answer <N>o to the prompt. Answering
  2812.         <Y>es under these circumstances will not damage the catalog file, but
  2813.         will cause confusion as to what disk the altered catalog records reside
  2814.         on.
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2836.  
  2837.                                       Page 42
  2838.  
  2839.  
  2840.  
  2841.         OPTION 4:  CATALOGING/RE-CATALOGING A DISK
  2842.  
  2843.         This selection will initiate cataloging or re-cataloging of the files
  2844.         on the selected catalog disk as shown in the status area at the top of
  2845.         the screen.  The volume label will be read, and if it doesn't exist,
  2846.         you will be given an opportunity to enter a volume label for the disk.
  2847.         If you hit <ESC> at the label prompt, the operation will be aborted and
  2848.         you will be returned to the main menu without cataloging your disk.
  2849.         After entering the label name for that disk, you will be asked if you
  2850.         wish to write that label to disk.  If you answer <Y>es, the disk will
  2851.         be labeled and cataloging will continue.  If you answer <N>o, the label
  2852.         will not be written, but the disk will be cataloged under the name that
  2853.         you gave it.  This will allow easy cataloging of write-protected disks.
  2854.  
  2855.         Please note that volume labels created by Peter Norton's "Volabel"
  2856.         utility may contain lower case characters.  CATDISK will convert the
  2857.         labels to upper case before adding them to the catalog.  This will
  2858.         enable you to manipulate and uncatalog any of these disks.  The
  2859.         physical volume label on the disk will be left unchanged.
  2860.  
  2861.         There are volume label utilities on the market that allow the entry of
  2862.         illegal characters into the volume label.  CATDISK will change these
  2863.         offending characters into spaces when it encounters them.  This will
  2864.         not affect the physical label on the disk, but rather the way CATDISK
  2865.         stores them in its catalog files.
  2866.  
  2867.         If the label on the disk to be cataloged already exists in the
  2868.         catalog, you will be notified of this situation, and will be given an
  2869.         opportunity to abort the operation.  This feature has been added as a
  2870.         safeguard against a situation where two disks of the same volume id may
  2871.         be overriding each other and clobbering the catalog contents of the
  2872.         other disk.  If you specified the "/NW" option on at startup, this
  2873.         warning will not be issued.
  2874.  
  2875.         If you specified /ALIAS in your startup options, a screen will appear
  2876.         showing you what the current volume label is on the disk you are about
  2877.         to catalog.  A prompt will appear below this asking you for a name
  2878.         under which you would like the disk to be cataloged.  The current
  2879.         volume label will be displayed in this area, and you will be allowed to
  2880.         change it before the cataloging process takes place.  This can be very
  2881.         handy in certain situations such as vendor disks that insist that the
  2882.         volume label remain unchanged, as the software uses the volume label to
  2883.         identify the disk.  The volume label on the disk may not mean anything
  2884.         to you, and  using an alias may be desirable in this case.
  2885.  
  2886.         As flexible as the ability to catalog under an alias can be, there are
  2887.         a couple of drawbacks that should be considered before you decide to
  2888.         make the name in the catalog different from the volume label on the
  2889.         disk.  Firstly, if you go to re-catalog the disk at a later time and
  2890.         don't provide exactly the same alias that was used initially, you can
  2891.         wind up with duplicate entries in the catalog file, as CATDISK
  2892.         currently has no way of knowing that the disk has already been
  2893.         cataloged.  Secondly, if at a later date, you use option #3 in CATDISK
  2894.         to change the volume label on a disk that has already been cataloged,
  2895.         CATDISK will have no way of knowing that it should give you the
  2896.         opportunity to change the entries in the catalog to reflect the new
  2897.         volume label, as the entries are not cataloged under the old volume
  2898.         label.
  2899.  
  2900.  
  2901.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2902.  
  2903.                                       Page 43
  2904.  
  2905.  
  2906.  
  2907.         The best advice would be that if you never intend to re-catalog a disk
  2908.         in the future, then it would be ok to use an alias, otherwise, it's
  2909.         best to stick with a meaningful volume label.
  2910.  
  2911.         Once the name of the disk has been established for cataloging purposes,
  2912.         the directory and any archive or library entries (if the ARCHIVE auto
  2913.         extract feature option is turned on - it is by default) will be read
  2914.         (if the ARCHIVE auto extract is set to QUERY, you will be asked for
  2915.         verification before a given archive or Library will be read).  This
  2916.         process will be repeated for each sub-directory on the disk as well.
  2917.         All existing levels of sub-directories will be searched.
  2918.  
  2919.         If the archive comment extract feature is turned on (see sub-option #0
  2920.         in the settings & toggles menu), CATDISK will extract the graphic
  2921.         resolution and color information of any GIF files that it encounters
  2922.         during its operation and place this information in the comment field
  2923.         (if it is a new file, or an existing entry in the catalog file that is
  2924.         blank) as the default comment.  For example, a picture contained in a
  2925.         GIF file that has a resolution of 640 by 480 pixels and contains 256
  2926.         colors will appear as "640x480x256".
  2927.  
  2928.         If CATDISK encounters a ZIP, ARJ, ZOO or DWC file, any comments that
  2929.         may be stored in that file will be read and included in the catalog
  2930.         file, if that archive is expanded.  If the operation is a re-cataloging
  2931.         operation and any extracted filenames already exist in the catalog file
  2932.         with comments attached, the comment from the archive file will be
  2933.         ignored.
  2934.  
  2935.         ZIP and ARJ files, in addition to supporting comment entries for each
  2936.         file contained, can also have a main comment for the ZIP/ARJ file
  2937.         itself.  When CATDISK reads ZIP/ARJ files and finds a main comment, it
  2938.         will insert that main comment in the catalog file for any entries in
  2939.         the ZIP/ARJ file that do not already have comments.  This feature of
  2940.         copying the main ZIP/ARJ file comment can be turned on and off via the
  2941.         settings and toggles menu as desired.
  2942.  
  2943.         If the 4DOS/NDOS comment extract feature is turned on (it is by
  2944.         default), CATDISK will attempt to find a file (that may be hidden) in
  2945.         each subdirectoy called "DESCRIPT.ION".  This file will be present if
  2946.         you have used the 4DOS/NDOS "Describe" command to add file descriptions
  2947.         to your directory entries.  If CATDISK is able to locate this file, it
  2948.         will automatically add any matching comments to your catalog entries
  2949.         where appropriate.
  2950.  
  2951.         If you have turned on the auto disk comment feature either from the
  2952.         command line or from the toggles menu, you will be prompted for a
  2953.         comment for the disk that will be shown in the disk summary report. If
  2954.         you are cataloging a new disk, the comment field will be blank.  If you
  2955.         are re-cataloging a disk, the previous comment for that disk will be
  2956.         the default.  To edit, just enter the new comment for the disk and hit
  2957.         <Enter>.  Hitting <Esc> will cause CATDISK to continue with no changes
  2958.         made to the existing comment as shown.
  2959.  
  2960.         If you do not have the auto disk comment feature turned on, you may
  2961.         still add/edit comments with the summary file comment editor, which is
  2962.         available from the main menu.
  2963.  
  2964.  
  2965.  
  2966.  
  2967.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  2968.  
  2969.                                       Page 44
  2970.  
  2971.  
  2972.  
  2973.         Upon completion of this, the catalog summary file will be updated.  If
  2974.         you have activated the Files/Disk Only prompt in the CDISKCFG.EXE
  2975.         configuration utility or specified the command line option /ALLORNONE
  2976.         when you started CATDISK, you will be asked if you want to catalog the
  2977.         disk only or include all files read from the disk.
  2978.  
  2979.         If you answer <D> for "disk only", the master catalog will not be
  2980.         updated unless appropriate entries need to be removed from the catalog
  2981.         due to the fact that the disk had been previously cataloged.
  2982.  
  2983.         If you answer <F> or did not activate the prompt in the first place,
  2984.         the master catalog will be updated to reflect the current
  2985.         directory/directories of the disk.  If any files have been added, they
  2986.         will be added to the catalog;  if any files have been changed, they
  2987.         will be updated;  if any files have been deleted, they will be removed
  2988.         from the catalog.
  2989.  
  2990.         If, while reading the disk, CATDISK cannot find any files there, it
  2991.         will ask you if you would like to add that disk to the catalog anyway.
  2992.         Why would you want to add such a disk to the catalog?  The answer to
  2993.         this question can best be explained by an example.
  2994.  
  2995.         You're maintaining a collection of disks for a computer users group.
  2996.         One day, you decide to clean up your collection, eliminating any
  2997.         duplicates that may have crept into the collection.  While you're
  2998.         eliminating the duplicates, several of the disks in the sequence become
  2999.         completely empty.  In this case, it is desirable to have the disk
  3000.         showing in the summary file as having its capacity completely available
  3001.         to accept new files.  Additionally, all the files that were eliminated
  3002.         from that disk will be un-cataloged by CATDISK through its normal
  3003.         function.  If the disk has never been cataloged before, this method
  3004.         represents a way to "pre-allocate" the disks to the collection and
  3005.         initialize their entries in the catalog file.
  3006.  
  3007.         If you would like to have the blank disk included in the catalog,
  3008.         answer YES to the prompt, otherwise, answer NO.  If you elect not to
  3009.         include the disk in the catalog file, and it has already been cataloged
  3010.         before, it would be advisable to remove that volume listing from the
  3011.         catalog file using option #5.
  3012.  
  3013.         Keep in mind, that deletion of an archive file will cause any files
  3014.         existing within that archive file to be uncataloged.  Also, turning the
  3015.         Auto Archive Extraction feature OFF, or answering <No> to a Extract
  3016.         Archive prompt to a cataloged Archive will cause any files in an
  3017.         Archive file on that disk to be uncataloged as well.
  3018.  
  3019.         Should the disk become full when the cataloging process is underway,
  3020.         the process will be aborted with an error message.  The old catalog
  3021.         file will remain intact (i.e. no changes made), but the summary file
  3022.         will reflect either the presence of the new disk, or the current status
  3023.         of that disk if it already existed in the catalog.  This means that the
  3024.         catalog file will not be accurate as to what's on the disk that you
  3025.         attempted to catalog.   If this error is encountered, you should either
  3026.         try to free up some space on disk on which the catalog file exists, or
  3027.         move the .DTA and .SUM files to another disk (see CONFIGURING CATDISK
  3028.         for details on how to access catalog files on other drives and
  3029.         directories) and retry the operation.
  3030.  
  3031.  
  3032.  
  3033.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3034.  
  3035.                                       Page 45
  3036.  
  3037.  
  3038.  
  3039.         The cataloging operation is completely automatic and does not require
  3040.         any further input from the operator once started, unless, of course,
  3041.         the ARCHIVE extract state is set to QUERY.
  3042.  
  3043.         If you have turned on the auto file comment feature either from the
  3044.         command line or from the toggles menu, you will be taken to a section
  3045.         of the program that will allow you to add/update file comments for the
  3046.         group of files that CATDISK just added to or updated in your catalog.
  3047.  
  3048.         See the discussion on "OPTION 6 - CHANGE COMMENTS BY VOLUME ID" for a
  3049.         discussion on how the comment editor works.
  3050.  
  3051.         Please keep in mind that CATDISK has an internal limitation of being
  3052.         able to read in only the first 6000 files of the disk being cataloged,
  3053.         including those read from within archive files if available memory
  3054.         permits.  CATDISK/D can handle up to 65500 files per disk being
  3055.         cataloged.
  3056.  
  3057.         If you find that CATDISK is not able to read in all of your disk for
  3058.         cataloging purposes, it could be that there is not enough free memory
  3059.         to be able to store all of the information.  If this is the case, try
  3060.         one or both of the following suggestions:
  3061.  
  3062.         1) Configure CATDISK's maximum disks/files per catalog setting to the
  3063.            smallest number that will contain your largest catalog file.  If the
  3064.            setting is unnecessarily large, more memory than is really needed
  3065.            will be set aside by CATDISK for internal use.
  3066.  
  3067.         2) Remove one or more resident (TSR) programs from memory to make more
  3068.            available for CATDISK to use.
  3069.  
  3070.         3) If you system is capable of using CATDISK/D, use that version, as
  3071.            its limitations are much higher.
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3100.  
  3101.                                       Page 46
  3102.  
  3103.  
  3104.  
  3105.         OPTION 5:  UNCATALOGING A DISK
  3106.  
  3107.         There may be times when you will wish to remove a disk's files from the
  3108.         catalog.  Select option <5> from the main menu, and you will be asked
  3109.         to enter the VOLUME NAME of the disk to be uncataloged.  Enter it and
  3110.         hit <Enter>.  If the volume label doesn't exist in the catalog, then
  3111.         you will be notified and returned to the main menu.
  3112.  
  3113.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  3114.         will bring up a point-and-shoot menu from which you can select a volume
  3115.         id from those in your current catalog.  See the section entitled
  3116.         "Selecting A Volume Name From A List" previously discussed in this user
  3117.         manual.
  3118.  
  3119.         If the volume label is found in the catalog, its entry will be deleted
  3120.         along with all the file names under it.
  3121.  
  3122.         If you do not wish to carry out this operation, hit <Esc> at the volume
  3123.         label prompt and no action will be taken.
  3124.  
  3125.         Should the disk become full during the catalog update process, the
  3126.         process will be aborted with an error message, and the old catalog file
  3127.         will remain intact.  Typically, this error should not occur, unless you
  3128.         have added more files to the disk, or another program has used up more
  3129.         disk space (such as a database expanding a file).  Should this error
  3130.         occur, the summary file will no longer contain a reference to the
  3131.         diskette that was uncataloged, but the catalog file will still contain
  3132.         references to that diskette.
  3133.  
  3134.         Should this be the case, you should either free up some space on the
  3135.         disk, or copy the .SUM and .DTA files to another disk (see CONFIGURING
  3136.         CATDISK for details on accessing catalog files on other drives and
  3137.         directories), catalog the diskette in question, and uncatalog it again.
  3138.         This will remove any references to that disk from the catalog file.
  3139.  
  3140.         If you do not have access to that disk any more (you may have erased
  3141.         it), simply take a blank diskette, add one file to it, and label it the
  3142.         same as the diskette you wish to uncatalog.  Carry out the above
  3143.         procedure, and you will obtain the same results.
  3144.  
  3145.         In practice, this should not happen, as you would have needed
  3146.         sufficient disk space to create the catalog file in the first place.
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3166.  
  3167.                                       Page 47
  3168.  
  3169.  
  3170.  
  3171.         OPTION F1: ADD/EDIT SUMMARY COMMENTS
  3172.  
  3173.         Selecting this option will activate the summary file comment editor.
  3174.         This is a very simple screen to operate.  Your disks currently
  3175.         cataloged will be listed on screen where you can scroll through the
  3176.         list and edit any comment as you deem necessary.
  3177.  
  3178.         Here's how the comment editor works:
  3179.  
  3180.         To change a comment, simply move the highlight to the disk entry that
  3181.         you wish to comment, and start typing.  When you are done, hit the
  3182.         <Return> key.
  3183.  
  3184.         Other editing keys are as follows:
  3185.  
  3186.           <Left Arrow>  - move cursor one character to the left.
  3187.           <Right Arrow> - move cursor one key to the right.
  3188.           <Home>        - move cursor to the beginning of the line
  3189.                           (once you have started typing).
  3190.           <End>         - move cursor to the end of the line
  3191.                           (once you have started typing).
  3192.           <Ctrl>-<End>  - erase from the cursor to the end of the line.
  3193.           <Del>         - delete the character at the cursor and shift the
  3194.                           characters on the right to the left.
  3195.           <Backspace>   - delete the character before the cursor and shift the
  3196.                           characters on the right to the left.
  3197.           <Ins>         - toggle insert/overstrike mode
  3198.                         - in insert mode the cursor will be slightly fatter
  3199.                           than the one in overstrike mode.
  3200.  
  3201.           <Esc>         - cancel the changes and restore the line to its
  3202.                           original contents.
  3203.  
  3204.         In some (and probably most) cases, the disk list will be too large to
  3205.         fit on the screen.  The list may be browsed through by using the keys
  3206.         on the cursor keypad.  Their functions:
  3207.  
  3208.         <UP> & <DOWN>   will move the highlight bar up or down one disk.  If
  3209.                         you at a screen margin, and there are still more
  3210.                         disks to be browsed, the listing on the screen will
  3211.                         scroll in the appropriate direction.  If you can't move
  3212.                         any more, you will hear a short beep.
  3213.  
  3214.         <PgUp> & <PgDn> will move you 15 disks forward or backward in the list
  3215.                         If you can't move any more, you will hear a short beep.
  3216.  
  3217.         <Home> & <End>  will move you to the beginning or end of the list of
  3218.                         disks respectively.
  3219.  
  3220.         <F9>            will repeat the last entered comment.  This is handy if
  3221.                         you want to repeat a single comment at different places
  3222.                         in the list where <F10> (below) won't suffice, as  the
  3223.                         comment desired is not directly above the current
  3224.                         position.  If no comment was previously entered, or the
  3225.                         last entered comment was blank, nothing will happen.
  3226.  
  3227.                         NOTE: The "last comment" for disk entries is different
  3228.                             from the one remembered for the file entries
  3229.                             (discussed later on in this document).
  3230.  
  3231.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3232.  
  3233.                                       Page 48
  3234.  
  3235.  
  3236.  
  3237.         <F10>           will "Ditto":  Pressing this key will copy the comment
  3238.                         from the entry above.  It is handy if you want to copy
  3239.                         a comment down a consecutive list of disks, or one that
  3240.                         was already previously entered at an earlier time, if
  3241.                         it is directly above the current position.  If the
  3242.                         comment above is blank, or you are at the top of the
  3243.                         list, no action will be taken.
  3244.  
  3245.         <Grey Plus>     move down through the list 1/15th of the total length
  3246.                         of the list (see the appendix regarding the SCROLL BAR
  3247.                         later in this manual).
  3248.  
  3249.         <Grey Minus>    move up through the list 1/15th of the total length of
  3250.                         the list (see the appendix regarding the SCROLL BAR
  3251.                         later in this manual).
  3252.  
  3253.         <Esc>           Return to the main menu when you are done.
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3298.  
  3299.                                       Page 49
  3300.  
  3301.  
  3302.  
  3303.         OPTION 6:  ADD/EDIT COMMENTS BY VOLUME ID
  3304.  
  3305.         There are two basic places from where CATDISK's comment editor may be
  3306.         invoked:  1) At the end of a cataloging operation when AUTOCOMMENTS is
  3307.         turned on; and 2) As a result of option #6, option #7, option #8 or
  3308.         option #9 from the main menu.
  3309.  
  3310.         The actual functionality of the comment editor will be discussed later
  3311.         on in this section.
  3312.  
  3313.         If you select this option #6 from the main menu, you will be asked to
  3314.         specify a disk volume. Upon entry of such, CATDISK will go through the
  3315.         catalog and bring a group of files into the comment editor that
  3316.         currently reside on that disk volume.
  3317.  
  3318.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  3319.         will bring up a point-and-shoot menu from which you can select a volume
  3320.         id from those in your current catalog.  See the section entitled
  3321.         "Selecting A Volume Name From A List" previously discussed in this user
  3322.         manual.
  3323.  
  3324.         Here's how the comment editor works:
  3325.  
  3326.         Once CATDISK has found a group of files for commenting, they will
  3327.         appear on the screen in a format similar to the "COMMENT" screen output
  3328.         format, the main difference being that one of the comments (or blanks)
  3329.         are highlighted in an inverse field.
  3330.  
  3331.         To change a comment, simply move the highlight to the file that you
  3332.         wish to comment, and start typing.  When you are done, hit the <Return>
  3333.         key.
  3334.  
  3335.         Other editing keys are as follows:
  3336.  
  3337.           <Left Arrow>  - move cursor one character to the left.
  3338.           <Right Arrow> - move cursor one key to the right.
  3339.           <Home>        - move cursor to the beginning of the line
  3340.                           (once you have started typing).
  3341.           <End>         - move cursor to the end of the line
  3342.                           (once you have started typing).
  3343.           <Ctrl>-<End>  - erase from the cursor to the end of the line.
  3344.           <Del>         - delete the character at the cursor and shift the
  3345.                           characters on the right to the left.
  3346.           <Backspace>   - delete the character before the cursor and shift the
  3347.                           characters on the right to the left.
  3348.           <Ins>         - toggle insert/overstrike mode
  3349.                         - in insert mode the cursor will be slightly fatter
  3350.                           than the one in overstrike mode.
  3351.  
  3352.           <Esc>         - cancel the changes and restore the line to its
  3353.                           original contents.
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3364.  
  3365.                                       Page 50
  3366.  
  3367.  
  3368.  
  3369.         In some (and probably most) cases, the file list will be too large to
  3370.         fit on the screen.  The list may be browsed through by using the keys
  3371.         on the cursor keypad.  Their functions:
  3372.  
  3373.         <UP> & <DOWN>   will move the highlight bar up or down one file.  If
  3374.                         you at a screen margin, and there are still more
  3375.                         files to be browsed, the listing on the screen will
  3376.                         scroll in the appropriate direction.  If you can't move
  3377.                         any more, you will hear a short beep.
  3378.  
  3379.         <PgUp> & <PgDn> will move you 15 files forward or backward in the list
  3380.                         If you can't move any more, you will hear a short beep.
  3381.  
  3382.         <Home> & <End>  will move you to the beginning or end of the group of
  3383.                         files respectively.
  3384.  
  3385.         <F2>            will repeat the comment on which the highlight bar
  3386.                         currently rests to all entries in the list of files.
  3387.                         If the currently highlighted comment is blank, a short
  3388.                         beep will sound and no further action will be taken.
  3389.                         This option provides a quick way to enter a single
  3390.                         comment for all files on an entire disk... just enter
  3391.                         the first one, re-highlight it and press <F5> to
  3392.                         duplicate it to each entry for that disk.  This option
  3393.                         is not shown at the bottom of the screen due to lack of
  3394.                         room on the instruction line.
  3395.  
  3396.         <F9>            will repeat the Last Entered Comment.  This is handy if
  3397.                         you want to repeat a single comment at different places
  3398.                         in the list where <F10> (see below) won't suffice, as
  3399.                         the comment desired is not directly above the current
  3400.                         position.  If no comment was previously entered, or
  3401.                         the last entered comment was blank, no action will be
  3402.                         taken.
  3403.  
  3404.         <F10>           will "Ditto":  Pressing this key will copy the comment
  3405.                         from the entry above.  It is handy if you want to copy
  3406.                         a comment down a consecutive list of files, or one that
  3407.                         was already previously entered at an earlier time, if
  3408.                         it is directly above the current position.  If the
  3409.                         comment above is blank, or you are at the top of the
  3410.                         list, no action will be taken.
  3411.  
  3412.         <Grey Plus>     move down through the list 1/15th of the total length
  3413.                         of the list (see the appendix regarding the SCROLL BAR
  3414.                         later in this manual).
  3415.  
  3416.         <Grey Minus>    move up through the list 1/15th of the total length of
  3417.                         the list (see the appendix regarding the SCROLL BAR
  3418.                         later in this manual).
  3419.  
  3420.         <Tab>           This will toggle the information shown on the left of
  3421.                         the comment area between three different formats, each
  3422.                         of which show different file information that may be
  3423.                         necessary to derive the desired comment.  This option
  3424.                         is not shown at the bottom of the screen due to lack of
  3425.                         room on the instruction line.
  3426.  
  3427.         <Esc>           Return to the main menu when you are done.
  3428.  
  3429.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3430.  
  3431.                                       Page 51
  3432.  
  3433.  
  3434.  
  3435.         OPTION 7:  ADD/EDIT COMMENTS BY FILESPEC
  3436.  
  3437.         If you select option #7 from the main menu, you will be asked for a
  3438.         filespec on which to base the search.  This filespec can be a based on
  3439.         CATDISK's enhancements to the DOS wildcard specifications (See option
  3440.         #0 (Reports And Inquiries), sub-option #4 (Show Files By Filespec) for
  3441.         a discussion of wildcard searching.  Once the catalog records are
  3442.         loaded into the comment editor according to your criteria, the same
  3443.         options that apply to option #6 apply here (see it for details).
  3444.  
  3445.  
  3446.         OPTION 8:  ADD/EDIT COMMENTS BY COMMENT
  3447.  
  3448.         If you select option #8 from the main menu, CATDISK will ask you for a
  3449.         comment spec on which to base the search.  Simply enter the sub-string
  3450.         for which you wish to search.  A discussion on how CATDISK matches
  3451.         comments can be found in the discussion on option #0 (Reports And
  3452.         Inquiries), sub-option #5 (Files by comment).  Once the catalog records
  3453.         are loaded into the comment editor according to your criteria, the same
  3454.         options that apply to option #6 apply here (see it for details).
  3455.  
  3456.  
  3457.         OPTION 9:  IMPORT COMMENTS FROM A TEXT FILE
  3458.  
  3459.         Option #9, "Import Comments From A Text File", will allow you to bring
  3460.         in file comments from an external source, be it a BBS listing that
  3461.         you've either downloaded or captured with your communications package,
  3462.         or any file that contains plain text.  This file can contain anything:
  3463.         filesizes, dates, times, etc.  The only limitations are that the file
  3464.         contain no tabs, and that each line be no longer than 255 characters.
  3465.  
  3466.         Many utilities such as Norton's fileinfo (FI) utility can re-direct
  3467.         their output to a text file simply by appending ">TEXTFILE" (without
  3468.         the quotes) to the command.  Using Norton's FI utility as an example,
  3469.         you could use "FI A: /C/L >TEXTFILE" to produce a file called TEXTFILE
  3470.         that would contain comments for many of the files on a floppy disk.
  3471.         Please refer to your Norton Utilities manual for details on how to
  3472.         maintain those comments with FI.
  3473.  
  3474.         Once you select option #9, a screen containing the controlling settings
  3475.         for the expected text file will appear.  These settings can be stored
  3476.         in a setup file (profile) for later retrieval.  To avoid disk clutter,
  3477.         profiles are stored in the same directory as your catalog files.  This
  3478.         eliminates the need for having to remember the settings for, say, the
  3479.         file dump from Norton's FI as described earlier on.  You can enter the
  3480.         settings once, save them to a profile and be able to recall them later
  3481.         on.  The first item on the screen indicates what file the current
  3482.         settings came from.
  3483.  
  3484.         The second item is the filename of the textfile from which the comments
  3485.         will be read.  The next 8 settings will depend on the characteristics
  3486.         of the file being read.  The pre-filled numbers assume that you are
  3487.         reading comments from CATDISK's own report printed to disk showing both
  3488.         statistics and comments.
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3496.  
  3497.                                       Page 52
  3498.  
  3499.  
  3500.  
  3501.         The first setting is the beginning and ending character positions of
  3502.         the filename as it appears on each line.  These settings are critical
  3503.         for CATDISK to be able to identify where to put each comment, and must
  3504.         contain a value greater than zero.
  3505.  
  3506.         The second setting is the beginning and ending character positions of
  3507.         the subdirectory, if it exists in the text file.  If the text file
  3508.         contains the subdirectory in which each file resides, you may include
  3509.         it with these settings, or if either the file does not contain
  3510.         subdirectory information, or you do not wish to use it, you may set the
  3511.         beginning and ending positions to zero.  CATDISK will then ignore them.
  3512.  
  3513.         The third setting is the beginning and ending character positions of
  3514.         the volume id, if it exists in the text file.  If the text file
  3515.         contains the volume id for the disk on which each file resides, you may
  3516.         include it with these settings, or if either the file does not contain
  3517.         this information, or you do not wish to use it, you may set the
  3518.         beginning and ending positions to zero.  CATDISK will then ignore them.
  3519.         Finally, the last setting is the starting and ending character
  3520.         positions of the file comment.  These values must also be set to
  3521.         something that is greater than zero, as CATDISK needs a comment to
  3522.         insert for each file that it finds in your catalog file.
  3523.  
  3524.         The easiest way to determine the appropriate settings for the text file
  3525.         you will be importing is to first load it into your favorite text
  3526.         editor.  Place the cursor on the beginning and ending characters of the
  3527.         various items discussed above, and note what column the editor
  3528.         indicates that the current cursor position is.  These will be the
  3529.         values that you will fill in to the control screen.
  3530.  
  3531.         Here are a few important notes regarding the text file.  There is
  3532.         really no need to edit blank lines and headings out of the file before
  3533.         processing, as the chances of CATDISK matching a filename, subdirectory
  3534.         and volume id found in the appropriate character positions in a heading
  3535.         with a file entry in the catalog file are quite slim.  It is important
  3536.         that each data line (not the headings) in the file be structured the
  3537.         same way (i.e. all the columns line up as in a report).  If this is not
  3538.         the case, chaos in the comments fields in the affected files will
  3539.         result.  Lastly, CATDISK has an internal limitation of being able to
  3540.         read in only the first 32,767 non-blank lines in the file.  The rest
  3541.         will be ignored.
  3542.  
  3543.         All this said, changing the settings is a matter of using the <Up> and
  3544.         <Down> arrow keys to highlight the desired setting, typing the new
  3545.         information for that setting and hitting <Enter>.  Pressing <Esc> when
  3546.         not editing a setting will return you to the menu with no further
  3547.         action taken.
  3548.  
  3549.         Retrieving and saving profiles is a simple matter of typing in the
  3550.         desired filename on the first line of the screen.  When you do so, you
  3551.         will be asked if you would like to read settings in from that file, or
  3552.         save the current ones to that file.  If you attempt to read in a
  3553.         profile that does not exist, you will be given an error message and no
  3554.         settings will be changed.  If, however, the file does exist and either
  3555.         a disk read error occurs or it is determined that the file is not a
  3556.         valid profile, the default settings (that which were supplied the first
  3557.         time you used this feature) will be brought in.
  3558.  
  3559.  
  3560.  
  3561.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3562.  
  3563.                                       Page 53
  3564.  
  3565.  
  3566.  
  3567.         If you wish to save the current settings to disk, CATDISK will first
  3568.         check to see if the file already exists.  If so, you will be given a
  3569.         warning to enable you to abandon the operation before you accidentally
  3570.         over-write a valuable program or data file.
  3571.  
  3572.         Any changes made in the settings during an import session will
  3573.         automatically be saved to the current profile on exit from the settings
  3574.         modification screen (via <Esc> or <F10>).  Again, if the file named in
  3575.         the first line exists, you will be given an overwrite warning in case
  3576.         you don't actually want to overwrite the current saved settings with
  3577.         the new ones (i.e. the import operation is a one-time shot in this
  3578.         case).
  3579.  
  3580.         Once you have all the desired settings ready, press <F10> to initiate
  3581.         the insertion of comments in the catalog file.  Here's what CATDISK
  3582.         does to accomplish this.  First, it will read and sort all the entries
  3583.         in the text file.  If CATDISK cannot find the text file, if there is an
  3584.         error in reading the text file, or there is an error in sorting the
  3585.         entries, the process will be aborted.  If the sort is successful,
  3586.         CATDISK will scan your current catalog file for matching entries from
  3587.         the text file.
  3588.  
  3589.         For each match that CATDISK finds, it will determine if the comment
  3590.         field from the catalog file is blank (CATDISK will not overwrite
  3591.         previously entered comments for the sake of integrity).  If so, the
  3592.         first 30 characters of the comment from the text file will be inserted
  3593.         into the comment field for that file in the catalog file.
  3594.  
  3595.         Once this process has completed, a list of the modified entries will be
  3596.         brought into the comment editor for "massaging" if you would like to
  3597.         clean up any entries.  It is highly recommended that you at least go
  3598.         through the list just to make sure that everything went ok.  See the
  3599.         discussion for option #7 - ADD/UPDATE COMMENTS BY FILESPEC for details
  3600.         on how the comment editor works.
  3601.         
  3602.         
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3628.  
  3629.                                       Page 54
  3630.  
  3631.  
  3632.  
  3633.         OPTION 0: REPORTS & INQUIRIES MENU
  3634.  
  3635.         This menu outlines the complete range of screen or printer-based
  3636.         reports that CATDISK is capable of generating.  Selection of an option
  3637.         from this menu is by conventional means as outlined in the section
  3638.         "Using The Menus" earlier on in this user manual.
  3639.  
  3640.         Note that if you have the Report Totals setting turned on, CATDISK will
  3641.         show totals for various items on screen reports, and at the end of
  3642.         disk-based and printer-based reports.
  3643.  
  3644.  
  3645.         Screen-based reports
  3646.         --------------------
  3647.  
  3648.         When viewing a report on your screen, there will be several options
  3649.         available to you.  The following are available in ALL screen based
  3650.         reports:
  3651.  
  3652.           <Cursor UP>   - move up one line in the report.  The screen contents
  3653.                           will scroll down to make room for the new line
  3654.                           appearing at the top.
  3655.  
  3656.           <Cursor DOWN> - move down one line in the report.  The screen
  3657.                           contents will scroll up to make room for the new line
  3658.                           appearing at the bottom.
  3659.  
  3660.           <PgUp>        - move up one page (15 lines) in the report.
  3661.           <PgDn>        - move down one page (15 lines) in the report.
  3662.           <Home>        - move to the beginning of the report.
  3663.           <End>         - move to the end of the report.
  3664.  
  3665.           <Grey Plus>   - move down through the report 1/15th of the total
  3666.                           length of the report (see the appendix regarding the
  3667.                           SCROLL BAR later in this manual).
  3668.  
  3669.           <Grey Minus>  - move up through the report 1/15th of the total length
  3670.                           of the report (see the appendix regarding the SCROLL
  3671.                           BAR later in this manual).
  3672.  
  3673.           <Esc>         - return to the menu.
  3674.  
  3675.           <Tab>         - switch between four different screen report formats
  3676.                           as follows:
  3677.  
  3678.                           1) The default format shows Filename, Volume ID,
  3679.                              Archive ID, Size, Date, Time and Dos File
  3680.                              Attributes.
  3681.  
  3682.                           2) Shows Subdirectory, Filename, Volume ID, Archive
  3683.                              ID, Size, Date, and Time.  This corresponds to the
  3684.                              /L1 option when starting CATDISK.
  3685.  
  3686.                           3) Shows Filename, Volume ID, Archive ID and File
  3687.                              comments.  This corresponds to the /L2 option.
  3688.  
  3689.                           4) Shows Subdirectory, Filename, Volume ID, Archive
  3690.                              ID and a slightly truncated file comment.  This
  3691.                              corresponds to the /L3 option.
  3692.  
  3693.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3694.  
  3695.                                       Page 55
  3696.  
  3697.  
  3698.  
  3699.         To jump quickly to a section in a file-based report, you may press any
  3700.         letter, number or punctuation key (except PLUS and MINUS, as they are
  3701.         already used elsewhere).  You will be immediately positioned in the
  3702.         report at the point where the primary item on which the report is
  3703.         sorted begins with that letter.
  3704.  
  3705.         With the following exceptions, all reports are primarily sorted on
  3706.         filename:
  3707.  
  3708.         1) Sorted Full File Listings.  The primary sort key will be the item
  3709.            listed beside the option in the Sorted Full File Listings menu.
  3710.            Reports sorted on items such as date/time, filesize or subdirectory
  3711.            will not have the ability to jump quickly in this manner, although
  3712.            all other options will.
  3713.  
  3714.         2) Custom reports.  The item with the lowest numbered column spec that
  3715.            also has a sort key specified will be the primary sort key.  Reports
  3716.            sorted on items such as date/time, file size, file attribute or
  3717.            subdirectory will not have the ability to jump quickly in this
  3718.            manner, although all other types of reports will have this ability.
  3719.  
  3720.         3) Disk Summary Report.  When sorted on volume label, the capability
  3721.            will exist.  When sorted on descending free space, the capability
  3722.            will not exist.
  3723.  
  3724.  
  3725.         Printer-Based Reports
  3726.         ---------------------
  3727.  
  3728.         If your report is going to a printer (LPT1 or LPT2), and you have
  3729.         activated the two-sided report feature of CATDISK, the odd numbered
  3730.         pages will be printed first, followed by a pause enabling you to reload
  3731.         the paper such that the even numbered pages will print on the back side
  3732.         of the odd numbered pages, followed by the even numbered pages.
  3733.  
  3734.         As the report is printed, the filenames or disk volumes (as appropriate
  3735.         to the report) will be echoed to your screen to keep you informed as to
  3736.         CATDISK's progress.
  3737.  
  3738.         While a report is being printed, you may press <Esc> to abandon the
  3739.         report and return you to the previous menu.
  3740.  
  3741.  
  3742.         Disk-Based Reports
  3743.         ------------------
  3744.  
  3745.         Disk reports are treated the same as printer reports, with the
  3746.         exception that the two-sided report feature does not apply.
  3747.  
  3748.         A listing in the same format as the hardcopy report will be produced in
  3749.         a diskette file.  The default name for this file is one with the same
  3750.         name as the current catalog filename with an extension of ".LST".  This
  3751.         may be overridden at the time that the report is generated.  Hitting
  3752.         <Esc> at any time during the generation of the report will abort it and
  3753.         return to the previous menu.
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3760.  
  3761.                                       Page 56
  3762.  
  3763.  
  3764.  
  3765.         Sub-Option #1: Disk Summary
  3766.         ---------------------------
  3767.  
  3768.         Selection of sub-option #1 from the reports menu will cause CATDISK to
  3769.         display an alphabetical list of VOLUME NAMES and some pertinent
  3770.         statistical information  for each.  This option is handy if, say, you
  3771.         have a bunch of utility disks and want to add a 14K utility program to
  3772.         one of them.  This report can be quite useful in making efficient use
  3773.         of existing working diskettes.
  3774.  
  3775.         All the statistical items shown should be self-explanatory, except one;
  3776.         that is, the Slack % factor.  The disks on which DOS stores it files
  3777.         are divided into allocation units called clusters.  The size of each
  3778.         cluster varies with the type and size of disk.  When DOS allocates
  3779.         space on a disk for a file, it is allotted in one cluster units to the
  3780.         file.  Some common cluster sizes are 512 bytes on 160-180K diskettes,
  3781.         and 1024 bytes on 320-360K diskettes.  Some hard disks have larger
  3782.         cluster sizes.
  3783.  
  3784.         Anyway, let's say, for example, that you have a file of 256 bytes.  On
  3785.         a 360K diskette, DOS will allocate 1024 bytes to the file, even though
  3786.         it is only 256 bytes long.  This means that three-quarters of that
  3787.         cluster is unused, or that you have 75% slack for that file.  The
  3788.         figure that you see on the summary report is the overall slack
  3789.         percentage of all the files on the disk.
  3790.  
  3791.         Depending on where you have set your output destination, the following
  3792.         options are applicable:
  3793.  
  3794.         NOTE:   If you select a printer or disk-based report from CATDISK,
  3795.                 you will be asked if you would like the report to be sorted on
  3796.                 volume ID or by descending free disk space.  Simply hit <V> for
  3797.                 the volume ID sort, or hit <F> for the descending free disk
  3798.                 space report.  Hitting <Esc> at this prompt will cause the
  3799.                 report to be aborted.
  3800.  
  3801.         NOTE:   You can have the screen-based report sorted by either volume
  3802.                 label or by descending free disk space.  You can toggle between
  3803.                 the two by pressing the <Space Bar>.  The starting order in
  3804.                 which the report will appear can be controlled with the /SL
  3805.                 command line option at startup.
  3806.  
  3807.     
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3826.  
  3827.                                       Page 57
  3828.  
  3829.  
  3830.  
  3831.         Sub-option #2: Files For A Volume
  3832.         ---------------------------------
  3833.  
  3834.         Selecting sub-option #2 will cause CATDISK to display an alphabetical
  3835.         list of files for a particular disk.  If you have the report
  3836.         destination set to "ASK", you will be asked for a report location.
  3837.         After the report destination is established, you will be asked for a
  3838.         volume ID.  The default is "*", which will include files from all
  3839.         volumes.  Simply enter the desired volume specification (wildcards
  3840.         permitted) and hit <Return>, or hit <Esc> to return to the menu without
  3841.         producing a report.
  3842.  
  3843.         Once the report location has been determined, CATDISK will ask you for
  3844.         the volume name to match for the report.  You can either enter the
  3845.         exact volume name to match, or a wild-card entry to match for the
  3846.         report.  If you enter an exact entry, CATDISK will first find it in the
  3847.         summary file.  If it does not exist, you will be notified, and the
  3848.         catalog scan will not even take place.  If you want to obtain a report
  3849.         for a group of volumes, here's how the wildcard matching works:
  3850.  
  3851.         As CATDISK scans your catalog for matches, it does a character by
  3852.         character comparison of the pattern that you specified and the volume
  3853.         name for each entry in your catalog.  As soon as a mismatch occurs, the
  3854.         catalog entry is not included in the report.  Two characters have a
  3855.         special meaning in these comparisons.  The question mark (?) will match
  3856.         any character in the position which the question mark occupies.  The
  3857.         asterisk (*) will match any characters to either the end of the volume
  3858.         name, or the next non-asterisk character in the pattern, if there are
  3859.         any.  As a result of this logic, any characters between two asterisks
  3860.         that may occur in the search pattern are ignored.
  3861.  
  3862.         One special case with the asterisk feature is when a pattern is placed
  3863.         in between two asterisks.  CATDISK will then match any volume that
  3864.         contains the pattern anywhere in the name.
  3865.  
  3866.         To better illustrate, here are some examples:
  3867.  
  3868.           Pattern    Volume ID  Match?
  3869.         ----------- ----------- ------
  3870.  
  3871.         VOLUME 1    VOLUME 1     YES
  3872.         VOLUME 1    VOLUME 2      NO   - not an exact match
  3873.         VOL?????    VOLUME 1     YES   - any 8 char name beginning with "VOL"
  3874.         VOL????2    VOLUME 2     YES   - any 8 char name beginning with "VOL"
  3875.                                          that ends with "2"
  3876.         VOL*1       VOLUME 1     YES   - any name beginning with "VOL" and
  3877.                                          ending in "1" (any number of chars)
  3878.         VOL*1       VOLUME 2      NO   - doesn't end in "1"
  3879.         *1          VOLUME 1     YES   - any name ending in "1" (any number of
  3880.                                          chars)
  3881.         *1          VOLUME 2      NO   - doesn't end in "1"
  3882.         ????????    VOLUME 1     YES   - any 8 char volume name
  3883.         ?????????   VOLUME 2      NO   - volume ID is not 9 characters long
  3884.         *           ANYVOLUME    YES   - any volume ID, any number of chars
  3885.         AB*CD*EF    ABEF         YES   - "CD" in the middle ignored
  3886.         *MISC*      CATMISC1     YES   - Contains "MISC" in the volume name.
  3887.  
  3888.  
  3889.  
  3890.  
  3891.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3892.  
  3893.                                       Page 58
  3894.  
  3895.  
  3896.  
  3897.         Note that in the last example, the presence of a leading and trailing
  3898.         asterisk will cause CATDISK to search for the characters enclosed
  3899.         between them as they appear literally.  Wildcard characters must not
  3900.         appear between these delimiters, as they cannot exist in a valid DOS
  3901.         filename (i.e. the volume id) and therefore will not be matched.  For
  3902.         example," *DI?K*" will cause CATDISK to search for "DI?K" in the volume
  3903.         id.  The question mark is not a valid character in a DOS filename,
  3904.         therefore no matches will be found.
  3905.  
  3906.         Optionally, you can leave the volume ID blank.  CATDISK will bring up a
  3907.         point-and-shoot menu from which you can select a volume id from those
  3908.         in your current catalog.  See the section entitled "Selecting A Volume
  3909.         Name From A List" previously discussed in this user manual.
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  3958.  
  3959.                                       Page 59
  3960.  
  3961.  
  3962.  
  3963.         Sub-option #3: Files For An Archive
  3964.         -----------------------------------
  3965.  
  3966.         Selecting sub-option #3 will cause CATDISK to display an alphabetical
  3967.         list of files for a particular archive.  If you have the report
  3968.         destination set to "ASK", you will be asked for a report location.
  3969.         After the report destination is established, you will be asked for a
  3970.         Archive to list.  The default is "*", which will include all files
  3971.         occurring in archives.  Simply enter the desired archive spec
  3972.         (wildcards permitted) and hit <Return>, or hit <Esc> to return to the
  3973.         menu without producing a report.  If you wish to obtain a report for a
  3974.         group of similarly named archives, you may use wildcards in your search
  3975.         spec.  Here's how they work:
  3976.  
  3977.         As CATDISK scans your catalog for matches, it does a character by
  3978.         character comparison of the pattern that you specified and the volume
  3979.         name for each entry in your catalog.  As soon as a mismatch occurs, the
  3980.         catalog entry is not included in the report.  Two characters have a
  3981.         special meaning in these comparisons.  The question mark (?) will match
  3982.         any character in the position which the question mark occupies.  The
  3983.         asterisk (*) will match any characters to either the end of the volume
  3984.         name, or the next non-asterisk character in the pattern, if there are
  3985.         any.  As a result of this logic, any characters between two asterisks
  3986.         that may occur in the search pattern are ignored.
  3987.  
  3988.         One special case with the asterisk feature is when a pattern is placed
  3989.         in between two asterisks.  CATDISK will then match any archive that
  3990.         contains the pattern anywhere in the name.
  3991.  
  3992.         Under normal circumstances, any files that are not contained in archive
  3993.         files will not appear in this report.  You must specifically ask for
  3994.         "........" (without the quotes) to get a listing of files that did not
  3995.         come from archives (i.e. Archive ID is "........" in the listing).
  3996.  
  3997.         To better illustrate, here are some examples:
  3998.  
  3999.         Pattern   Archive ID  Match?
  4000.         --------  ----------  ------
  4001.         MISC1     MISC1        YES
  4002.         MISC1     MISC2         NO   - not an exact match
  4003.         MI???     MISC1        YES   - any 5 char name beginning with "MI"
  4004.         MI??2     MISC2        YES   - any 5 char name beginning with "MI"
  4005.                                        that ends with "1"
  4006.         MI*1      MISC1        YES   - any name beginning with "MI" and ending
  4007.                                        in "1" (any number of chars)
  4008.         MI*1      MISC2         NO   - doesn't end in "1"
  4009.         *1        MISC1        YES   - any name ending in "1" (any # of chars)
  4010.         *1        MISC2         NO   - doesn't end in "1"
  4011.         ?????     MISC1        YES   - any 5 char volume name
  4012.         ????????  MISC2         NO   - archive ID is not 8 characters long
  4013.         *         ANYARCH      YES   - any archive ID, any number of chars
  4014.         AB*CD*EF  ABEF         YES   - "CD" in the middle ignored
  4015.         *GAME*    AGAME001     YES   - Contains "GAME" in the archive name
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4024.  
  4025.                                       Page 60
  4026.  
  4027.  
  4028.  
  4029.         Note that in the last example, the presence of a leading and trailing
  4030.         asterisk will cause CATDISK to search for the characters enclosed
  4031.         between them as they appear literally.  Wildcard characters must not
  4032.         appear between these delimiters, as they cannot exist in a valid DOS
  4033.         filename (i.e. the archive id) and therefore will not be matched.  For
  4034.         example," *DI?K*" will cause CATDISK to search for "DI?K" in the
  4035.         archive id.  The question mark is not a valid character in a DOS
  4036.         filename, therefore no matches will be found.
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4090.  
  4091.                                       Page 61
  4092.  
  4093.  
  4094.  
  4095.         Sub-option #4: Files By Filespec
  4096.         --------------------------------
  4097.  
  4098.         Selecting sub-option #4 will cause CATDISK to display an alphabetical
  4099.         list of files for a DOS or a CATDISK enhanced wildcard spec.  If you
  4100.         have the report destination set to "ASK", you will be asked for a
  4101.         report location.  After the report destination is established, you will
  4102.         be asked for a filespec.  The default is "*.*", which will include all
  4103.         files.  This filespec follows the conventional DOS filespec search
  4104.         conventions including wildcard searches.  Hit <Esc> to return to the
  4105.         menus without generating a report.
  4106.  
  4107.         Examples:
  4108.  
  4109.                *.*        - search for everything
  4110.                *          - same as *.*
  4111.                *.         - search for files with no extension
  4112.         CATDISK*.*        - search for files starting with CATDISK and having
  4113.                             any file extension
  4114.         CATDISK*          - same as CATDISK*.*
  4115.         CATDISK*.         - search for files starting with CATDISK and having
  4116.                             no file extension
  4117.                *.COM      - search for files ending in .COM
  4118.               A*.EXE      - search for files starting with A and ending in .EXE
  4119.          CATDISK.EXE      - search specifically for CATDISK.EXE
  4120.                *.?Q?      - search for files with an extension containing Q as
  4121.                             its second character
  4122.               ??.DOC      - search for files with two letters as it filename
  4123.                             and .DOC as its extension
  4124.  
  4125.         Please refer to the DOS manual for further information on file
  4126.         searching patterns.
  4127.  
  4128.         In addition to the standard DOS wildcard matching specifications,
  4129.         CATDISK adds capabilities similar to the pattern matching discussed
  4130.         earlier in the manual under volume name matching and archive id
  4131.         matching.  To apply it to a filename, simply split the filename into
  4132.         its two sections (the part before the period is referred to as the
  4133.         name, and the part after the period is the extension), and apply the
  4134.         principals to each part.  A couple of examples would be:
  4135.  
  4136.             *D.*   - match any filename whose name ends in "D" and has any
  4137.                      extension.
  4138.           C?T*.EXE - match any filename whose name has a "C" in the first
  4139.                      position, any character in the second position, a "T" in
  4140.                      the third position, and has an extension of ".EXE".
  4141.              *.*M  - match any file with any extension that ends in "M".
  4142.            C*K.*   - match any file with any extension whose name starts with
  4143.                      "C" and ends with "K".
  4144.          *DISK*.*  - match any file whose name contains the characters "DISK".
  4145.  
  4146.         Note that in the last example, the presence of a leading and trailing
  4147.         asterisk will cause CATDISK to search for the characters enclosed
  4148.         between them as they appear literally.  Wildcard characters must not
  4149.         appear between these delimiters, as they cannot exist in a valid DOS
  4150.         filename and therefore will not be matched.  For example," *DI?K*.*"
  4151.         will cause CATDISK to search for "DI?K" in the files name.  The
  4152.         question mark is not a valid character in a DOS filename, therefore no
  4153.         matches will be found.
  4154.  
  4155.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4156.  
  4157.                                       Page 62
  4158.  
  4159.  
  4160.  
  4161.         Although this is a slight departure from the DOS standard for file
  4162.         pattern matching, I'm sure that you will find that these extensions add
  4163.         a little more flexibility and power to CATDISK's reporting
  4164.         capabilities.
  4165.  
  4166.  
  4167.         Sub-option #5: Files By Subdirectory
  4168.         ------------------------------------
  4169.  
  4170.         Selecting sub-option #5 will bring up an alphabetical list of files for
  4171.         a DOS or a CATDISK enhanced wildcard subdirectory specification. When
  4172.         specifying the desired directory to list, NO NOT INCLUDE THE "\" or "~"
  4173.         in the name - CATDISK only processes the name portion of the
  4174.         subdirectory entry in the catalog.
  4175.  
  4176.         If you have the report destination set to "ASK", you will be asked for
  4177.         a report location.  After the report destination is established, you
  4178.         will be asked for the desired subdirectory.  This specification follows
  4179.         the conventional DOS filespec search conventions including wildcard
  4180.         searches as well as the enhanced features that CATDISK offers.  Details
  4181.         on wildcard searches may be found in the section of this manual dealing
  4182.         with the "Files by Filespec" report.
  4183.  
  4184.         Hit <Esc> to return to the menus without generating a report.
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4222.  
  4223.                                       Page 63
  4224.  
  4225.  
  4226.  
  4227.         Sub-option F1: Files By Comment Text
  4228.         ------------------------------------
  4229.  
  4230.         Selecting sub-option #5 will cause CATDISK to display a list of files
  4231.         in accordance with a comment search spec that you supply.  Although
  4232.         CATDISK supports comments of 43 characters in length, the search spec
  4233.         is currently limited to 35 characters, which should suffice for all
  4234.         options.  After selecting a report destination, you will be asked for a
  4235.         comment search spec that you wish the report to be based on.
  4236.  
  4237.         Just enter the string that you want to search for in the catalog's
  4238.         comments section and hit <Enter>, or hit <Esc> to abort the process
  4239.         without generating a report.
  4240.  
  4241.         Here's how the comments are sourced for your search spec.  You enter a
  4242.         "phrase" or "substring" that you want to search for in the file
  4243.         comments.
  4244.  
  4245.         The "phrase" may be an entire comment that you want, it can be just one
  4246.         word, or even just one letter.  When CATDISK compares your "phrase" to
  4247.         a comment, it checks to see if that "phrase" is contained anywhere in
  4248.         that comment.  If it does, that file will appear in your report.
  4249.  
  4250.         Example:   "SOURCE" would match:    CATDISK V4.13 source code
  4251.                                             CATDISK V4.13 Source code
  4252.                                             CATDISK V4.13 SOURCE CODE
  4253.                                             Source
  4254.                                                      ... etc ...
  4255.  
  4256.         Leaving the comment entry blank will produce a report containing only
  4257.         the catalog entries that have no comment.
  4258.  
  4259.         Please note:  Several users have asked for wild cards in the comment
  4260.         search (eg.  they might not know whether they had "Word Processor" or
  4261.         "Word Proc" for a comment).  This is not really necessary in this case,
  4262.         as, in the above case, entering "PROC" would match both comments.
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4288.  
  4289.                                       Page 64
  4290.  
  4291.  
  4292.  
  4293.         Sub-option F3:  Files By Comment Keywords
  4294.         -----------------------------------------
  4295.  
  4296.         Upon selecting <F1> from the reports menu, CATDISK will ask you for one
  4297.         or more keywords to match when generating the report.  All keywords are
  4298.         entered on one line, each separated by a space.  The maximum length of
  4299.         this line is 35 characters.
  4300.  
  4301.         Unlike the "Files By Comment Text" report mentioned earlier in this
  4302.         manual, the keyword report will scan through your file comments and
  4303.         look for whole words instead of looking for the text anywhere in the
  4304.         comment.
  4305.  
  4306.         For example, entering "PROCESS" for a keyword would cause a match in
  4307.         the comment "PROCESS CONTROL", but would not cause a match in the
  4308.         comment "WORD PROCESSOR" due to the fact that the "PROCESS" in
  4309.         "PROCESSOR" is not a stand alone word.
  4310.  
  4311.         You can have CATDISK perform the matching operations on multiple
  4312.         keywords by entering them all on the specification line, each separated
  4313.         by a space.  If CATDISK detects that you are looking for more than one
  4314.         keyword, you have two choices on how those keywords will be processed
  4315.         when evaluating a match with a file comment.
  4316.  
  4317.         You will see the prompt:
  4318.  
  4319.             Match Just <O>ne of These Keywords or <A>ll of Them? <O/A>
  4320.  
  4321.         By answering:
  4322.  
  4323.         O) You can have CATDISK assume a match if any one of the keywords are
  4324.            found in the comment.  You may also press the <1> key (instead of
  4325.            the first letter of the word ONE).
  4326.  
  4327.            eg. Keywords:  CATDISK SUMMARY
  4328.                Comment :  CATDISK Summary File For Games   - Match!
  4329.                Comment :  Summary of Monthly Sales         - Match!
  4330.                Comment :  3.. 2.. 1.. Blastoff!            - No Match
  4331.  
  4332.         A)  You can tell CATDISK to include a file in the report only if ALL
  4333.             keywords are found in the comment.  If one or more keywords are not
  4334.             present in the comment, the file will not appear in the report.
  4335.  
  4336.             Using the examples from the previous choice will show the
  4337.             difference in how the comments are evaluated.
  4338.         
  4339.            eg. Keywords:  CATDISK SUMMARY
  4340.                Comment :  CATDISK Summary File For Games   - Match!
  4341.                Comment :  Summary of Monthly Sales         - No Match
  4342.                Comment :  3.. 2.. 1.. Blastoff!            - No Match
  4343.  
  4344.            The second comment does not match under the second criteria due to
  4345.            the fact that the word Summary is present, but the word CATDISK is
  4346.            not.
  4347.  
  4348.  
  4349.         Having both a comment text report and a separate keyword-based report
  4350.         gives you full flexibility in searching for files by comment.
  4351.  
  4352.  
  4353.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4354.  
  4355.                                       Page 65
  4356.  
  4357.  
  4358.  
  4359.         Sub-option #6:  Files By Comment/Filename Text
  4360.         ----------------------------------------------
  4361.  
  4362.         This report is very similar to the Files By Comment Text report except
  4363.         that the filename is also searched for any occurrences of the search
  4364.         spec.  See details on the "Files By Comment Text" report in this user
  4365.         manual for details on how text is compared to determine whether or not
  4366.         a given file should appear in the report.
  4367.  
  4368.  
  4369.         Sub-option #7: Unique Files Only & Sub-option #8: Duplicate Files Only
  4370.         ----------------------------------------------------------------------
  4371.  
  4372.         Selecting sub-option #8 will cause CATDISK to display a listing of
  4373.         files in your catalog that exist only once.  Selecting sub-option #9
  4374.         will cause CATDISK to display a listing of files that occur more than
  4375.         once in your catalog.
  4376.  
  4377.         The criteria for these two reports is based solely on the filename, and
  4378.         optionally, on the file size (you will be asked whether or not you want
  4379.         it to be included before the catalog scan takes place), and not other
  4380.         items such as subdirectory, file date or file size.  you will be given
  4381.         the option to include or not to include the file size as a criteria in
  4382.         determining a file's uniqueness when you initiate one of these two
  4383.         sub-options.
  4384.  
  4385.         When either of these reports is generated, a full scan will be made
  4386.         through the catalog file to determine which files should be included in
  4387.         the report.  The reason for this is due to the method that CATDISK uses
  4388.         in comparing filenames to determine whether they are duplicate or
  4389.         unique.
  4390.  
  4391.         If, during the scanning process, CATDISK runs into a disk problem, the
  4392.         report will be aborted.
  4393.  
  4394.         Due to the method by which CATDISK scans the catalog, there is a
  4395.         possibility that duplicate files may appear in the unique file reports
  4396.         and vice versa when file size is used as a criteria if the given
  4397.         entries being compared are not right together in the catalog file.  An
  4398.         example may make this clearer:
  4399.  
  4400.         Filename.Ext  Volume ID    File Size
  4401.  
  4402.         TEST    .GIF  GIF0001        123,456
  4403.         TEST    .GIF  GIF0002        123,789
  4404.         TEST    .GIF  GIF0003        123,456
  4405.  
  4406.         In the unique file report, for example, if the file size is omitted
  4407.         from the search criteria, the report will show none of the above three
  4408.         files, which would be correct.
  4409.  
  4410.         If, however, the file size is included, all three of the files will
  4411.         show up due to the fact that the second entry in the file list has a
  4412.         different file size.  The first file is compared to the second one, and
  4413.         the second one is compared to the third during the sequential search of
  4414.         the catalog.  Due to the possibility that there can be many files of
  4415.         the same name occurring in the catalog file, this cannot be currently
  4416.         circumvented.
  4417.  
  4418.  
  4419.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4420.  
  4421.                                       Page 66
  4422.  
  4423.  
  4424.  
  4425.         A similar situation can happen in the duplicate files report.  Leaving
  4426.         the file size out of the criteria will yield the correct results.
  4427.         Including it may cause all three files to be left out of the report for
  4428.         the same reasons as in the unique file report.
  4429.  
  4430.  
  4431.  
  4432.         Sub-option #9: Volume Summary/Contents
  4433.         --------------------------------------
  4434.  
  4435.         This report is like combining the summary report with a full file
  4436.         listing.  CATDISK will print each line from your summary report,
  4437.         followed by a complete listing of files contained on that disk.
  4438.  
  4439.         Due to the nature of this report and the methodology that CATDISK uses
  4440.         to generate it, it is not possible to view this report on your screen.
  4441.         A printer location or a disk file must be selected in order to produce
  4442.         this report.
  4443.  
  4444.         If you instruct CATDISK to send this report to the screen, you will get
  4445.         an error message informing you of the above requirements.
  4446.  
  4447.  
  4448.         Sub-option #0:  Sorted Full File Listings
  4449.         -----------------------------------------
  4450.  
  4451.         This option, if viewed on the screen will product a report in the same
  4452.         manner as sub-option #4, except that ALL files in the catalog will be
  4453.         included in the list.  It is similar to choosing sub-option #4 and
  4454.         searching for "*.*".
  4455.  
  4456.         If you have the report destination set to "ASK", you will be asked for
  4457.         a report location before any further action takes place.
  4458.  
  4459.         You may sort the full list on various criteria.  Currently, you can
  4460.         sort by filename, file extension, subdirectory, volume id, archive id,
  4461.         comment, file date/time (descending order), or file size (descending or
  4462.         ascending order).
  4463.  
  4464.         To select a criteria, simply hit the number beside it, or select it
  4465.         from the menu using CATDISK's menu selection methods.  The rest is
  4466.         automatic.
  4467.  
  4468.         If, during the sorting phase, which occurs for each option, with the
  4469.         exception of option #1, an error occurs, the process will be aborted
  4470.         and no report will be generated.
  4471.  
  4472.  
  4473.         Sub-option <Esc>: Return To Main Menu
  4474.         -------------------------------------
  4475.  
  4476.         Hitting <Esc> will return you to CATDISK's main menu.
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4486.  
  4487.                                       Page 67
  4488.  
  4489.  
  4490.  
  4491.         Sub-option F2: Custom Reports
  4492.         -----------------------------
  4493.  
  4494.         The Report Selection Screen
  4495.         ---------------------------
  4496.  
  4497.         The first screen that you will see upon selecting this option (after
  4498.         selecting a report location) is the list of available reports with the
  4499.         first line being an option to define a new report.  It is from this
  4500.         screen that you may create new reports, re-define any existing ones,
  4501.         delete reports from the list or select a report to create.
  4502.  
  4503.         You may define any number of reports, the only limitation being
  4504.         available disk space.  They will be kept in a file called
  4505.         "CATDISK.RPT", which is stored in the catalog file directory (the same
  4506.         directory in which your catalog files are stored).
  4507.  
  4508.         You can move through the list by using the cursor keypad as follows:
  4509.  
  4510.         <Up Arrow>   - Move up 1 line in the list if possible.
  4511.         <Down Arrow> - Move down 1 line in the list if possible.
  4512.         <PgUp>       - Move up 1 screenful in the list if possible.
  4513.         <PgDn>       - Move down 1 screenful in the list if possible.
  4514.         <Home>       - Move to the top of the list.
  4515.         <End>        - Move to the end of the list.
  4516.  
  4517.         To define a new report, move the highlight bar up to the top of the
  4518.         list so that the entry <Create New Report> is highlighted.  Now, hit
  4519.         either <F2> or the <Enter> key.  You will be brought into the report
  4520.         criteria editor, which will be discussed a bit later.
  4521.  
  4522.         To modify an existing report, highlight that report and hit the <F2>
  4523.         key.  The report specification will be brought into the report criteria
  4524.         editor, which is discussed a bit later.
  4525.  
  4526.         To delete a report, highlight that report and hit <Alt>-<D>.  The
  4527.         report will be immediately deleted, so use this option with caution.
  4528.  
  4529.         To generate a previously defined report, highlight that report and
  4530.         press the <Enter> key.  You will be asked if you wish to make any
  4531.         temporary changes to the report.  If you wish to produce the report as
  4532.         defined, answer "NO" to the question.  If you answer YES, the report
  4533.         definition screen will appear from which you may make any one-time
  4534.         changes for the current run of the report.  These changes will not be
  4535.         permanently saved.
  4536.  
  4537.         To return to the reports menu, hit the <Esc> key.
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4552.  
  4553.                                       Page 68
  4554.  
  4555.  
  4556.  
  4557.         Defining A Report
  4558.         -----------------
  4559.  
  4560.         The report definition screen is divided into five areas:
  4561.  
  4562.         1) The report title.
  4563.         2) The selection specifications.
  4564.         3) The selection criteria.
  4565.         4) The column specifications.
  4566.         5) The sort specifications.
  4567.  
  4568.         Items 2 and 3 work together in tandem, as do items 4 and 5.  Note that
  4569.         selection criteria for the file time and attribute are not available,
  4570.         nor is a criteria for the comment (as denoted by the fine periods
  4571.         filling the item.  The former two are present to accommodate inclusion
  4572.         in the report columns.
  4573.  
  4574.         To change an entry, use the cursor keypad to move the highlight around
  4575.         the screen.  Detailed editing instructions for each field will appear
  4576.         in the instruction area at the bottom of the screen.
  4577.  
  4578.         We will now discuss the five areas of this screen and how they affect
  4579.         the output and appearance of the report.
  4580.  
  4581.         1) Title
  4582.  
  4583.            The entered title will appear at the top of each page of the
  4584.            generated report when sent to disk or printer.
  4585.  
  4586.         2) Selection Specifications
  4587.  
  4588.            By default, all specifications are blank.  As such, CATDISK will not
  4589.            check to see if a catalog entry "fits" that description.  The entry
  4590.            will automatically "pass" that check.  If, however, you fill in a
  4591.            spec for a particular item, it will be checked in accordance with
  4592.            its corresponding selection criteria, which will appear immediately
  4593.            beside it.  If the catalog entry "passes" all tests which have
  4594.            criteria filled in it will be included in the report.
  4595.  
  4596.            When filling out filespecs, subdirectories, volume labels and
  4597.            archive specs, you may use CATDISK's wildcard matching conventions.
  4598.            Other specifications are entered verbatim.  When entering a comment
  4599.            specification, you should be aware that comments are evaluated in
  4600.            the same manner as that of the "Files By Comment" report.
  4601.  
  4602.            To clear out a specification, just fill it with spaces.
  4603.  
  4604.         3) Selection Criteria
  4605.  
  4606.            For each non-blank selection specification entered, a selection
  4607.            criteria will appear beside it.  Possible "values" for the selection
  4608.            criteria (which are self-explanatory) may be as follows:
  4609.  
  4610.            Equal To
  4611.            Not Equal To
  4612.            Less Than
  4613.            Less Than or Equal To
  4614.            Greater Than
  4615.            Greater Than or Equal To
  4616.  
  4617.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4618.  
  4619.                                       Page 69
  4620.  
  4621.  
  4622.  
  4623.            If a selection specification contains wildcard specifications (i.e.
  4624.            contains the characters "?" or "*"), only the first two "values"
  4625.            will be applicable.  If the selection specification is exact, all 6
  4626.            may be possible.
  4627.  
  4628.            To change the selection criteria, hit the <Space Bar> when it is
  4629.            highlighted.  CATDISK will cycle through the possible choices, based
  4630.            on the above discussion.
  4631.  
  4632.         4) Column Specifications
  4633.  
  4634.            The column specifications will allow you to control which items from
  4635.            each catalog entry will appear in your report, and in which order.
  4636.  
  4637.            Fill in a number from 1 to 9 for each item that you wish to appear
  4638.            in the report.  The lowest numbered item will comprise the leftmost
  4639.            column, the second lowest numbered item will be next, and so on to
  4640.            the highest numbered item, which will be the rightmost item.
  4641.  
  4642.            Any item that is blank will be omitted from the report.
  4643.  
  4644.            To change the column spec, just hit the key of the number which you
  4645.            wish to assign to the spec.  If you try to duplicate a number that
  4646.            has already been assigned, the duplicate will be rejected with a
  4647.            beep.  To clear out a spec, enter <0> for it or hit the <Space Bar>.
  4648.  
  4649.            Note that it is possible to define a report that will be wider than
  4650.            the screen's width.  A screen-based report may be up to 78
  4651.            characters wide.  Any excess characters will be trimmed.
  4652.  
  4653.            When sending a report to your printer, CATDISK will assume that you
  4654.            have your printer appropriately set up (either via the printer setup
  4655.            codes) or via the control panel on the printer itself.
  4656.  
  4657.         5) Sort Specifications
  4658.  
  4659.            These settings determine the order in which the catalog entries will
  4660.            appear in your report.  Possible settings for the sort specs are:
  4661.  
  4662.            Blank            - don't bother sorting on this item
  4663.            Ascending Order  - sort this item in order from lowest to highest.
  4664.            Descending Order - sort this item in order from highest to lowest.
  4665.  
  4666.            You may specify more than one item as a sort spec, as long as it has
  4667.            a column spec assigned to it.  The lowest numbered sort
  4668.            specification will be the primary key, the next lowest specification
  4669.            will be the next key, and so on.  The second key will only be used
  4670.            if the first item of catalog items being compared are the same.  A
  4671.            third key would be used (if specified) only if the first two items
  4672.            are the same.
  4673.  
  4674.            Note that there is no sort criteria for file attribute or file time.
  4675.            In the case of file time, a sort criteria set on the file date will
  4676.            also result in all files from that date also being sorted in the
  4677.            appropriate order by file time.
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4684.  
  4685.                                       Page 70
  4686.  
  4687.  
  4688.  
  4689.            To illustrate an example, suppose you have the setup:
  4690.  
  4691.            Item        Col  Sort Spec
  4692.  
  4693.            Filename:    2   Decending Sort
  4694.  
  4695.            Volume ID:   1   Ascending Sort
  4696.  
  4697.            A snippet of a report might show up as:
  4698.  
  4699.            Volume ID   Filename.ext
  4700.  
  4701.            DISK00001   BBBBB   .ZIP
  4702.            DISK00002   DDDDD   .ZIP
  4703.            DISK00003   CCCCC   .ZIP
  4704.            DISK00003   AAAAB   .ZIP
  4705.            DISK00003   AAAAA   .ZIP
  4706.            DISK00004   HHHHH   .ZIP
  4707.            DISK00004   GGGGG   .ZIP
  4708.  
  4709.            Note that where the volume id is the same in DISK00003 and
  4710.            DISK00004, the filenames within that item are then sorted in
  4711.            decending order as per the column sort specs.
  4712.  
  4713.  
  4714.         The best way to familiarize yourself with CATDISK's custom reporting
  4715.         facility is to experiment with it.  You will do no harm to your data
  4716.         files, and you can always delete any erroneous reports from the list or
  4717.         correct them at a later time.  The flexibility of this custom reporting
  4718.         facility is almost unlimited in its capability.  About the only thing
  4719.         that cannot be evaluated here is whether or not a file is a duplicate.
  4720.         We provide the "canned" reports to handle thisspecial case.
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4750.  
  4751.                                       Page 71
  4752.  
  4753.  
  4754.  
  4755.         OPTION <F4> - TEMPORARILY EXIT TO DOS
  4756.         -------------------------------------
  4757.  
  4758.         This option, although not really necessary, has been added in response
  4759.         to the numerous requests that I have had for this feature (shows that I
  4760.         am really paying attention to those suggestions, eh?).  By selecting
  4761.         this option, CATDISK will be temporarily suspended and you will be
  4762.         returned to the DOS prompt.  You may carry out any normal function that
  4763.         you would ordinarily be able to carry out from DOS, provided that there
  4764.         is enough memory remaining in which to run your desired program.
  4765.  
  4766.         Please note that if you have the disk cache active at the time you use
  4767.         this function, the contents of the cache will be flushed and cleared
  4768.         before calling DOS.  This will not affect any data already on disk.
  4769.  
  4770.         When you are finished with DOS, and wish to return to CATDISK, simply
  4771.         type "EXIT" and hit <Return> to return to CATDISK.  Please be sure and
  4772.         replace any disks that you had in your drives before returning to
  4773.         CATDISK.
  4774.  
  4775.         Note that although the <F4> option does not appear on any of CATDISK's
  4776.         other menus (settings & toggles, reports & inquiries, or the report
  4777.         destination selection menu), you may press <F4> from any of these menus
  4778.         to temporarily exit to DOS.  When you return from DOS, you will be
  4779.         returned to the particular menu from which you shelled out to DOS.
  4780.  
  4781.         Possible errors that you may encounter when you use can vary greatly.
  4782.  
  4783.         Possibilities are:  1) There is not enough memory to load a second copy
  4784.                                of the command interpreter (usually
  4785.                                COMMAND.COM), or that memory has been corrupted
  4786.                                by a resident program.
  4787.  
  4788.                             2) If you get an error after returning from DOS, it
  4789.                                usually means that you've loaded a resident
  4790.                                program while out in DOS.  You should refrain
  4791.                                from doing so.
  4792.  
  4793.                             3) Another possibility is that CATDISK was unable
  4794.                                to find the command interpreter (usually
  4795.                                COMMAND.COM) on the drive and directory defined
  4796.                                by the COMSPEC environment string (see the DOS
  4797.                                manual for details on the SET command).  This is
  4798.                                usually set to the location from which
  4799.                                COMMAND.COM was loaded when the system was
  4800.                                booted. If COMMAND.COM was not found at the boot
  4801.                                location, the root directory of the current
  4802.                                drive is attempted.
  4803.  
  4804.         For the technically minded, here are the error codes that may be
  4805.         returned.
  4806.  
  4807.           1 - Insufficient memory to store CATDISK's free list (internal).
  4808.           2 - DOS setblock error before shell to DOS was attempted.
  4809.           3 - DOS setblock error after the shell to DOS was executed (critical
  4810.               error).
  4811.           4 - Insufficient memory available to run the DOS command.
  4812.           else a DOS error code.
  4813.  
  4814.  
  4815.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4816.  
  4817.                                       Page 72
  4818.  
  4819.  
  4820.  
  4821.         OPTION <drive_letter>: SHOW DISK DIRECTORY
  4822.  
  4823.         To activate this feature, simply type the drive letter of the disk
  4824.         whose directory you wish to view.  If you haven't included the /NW
  4825.         option in your command line when you started CATDISK, you will be
  4826.         prompted to insert a disk for drive D where D is the drive letter that
  4827.         you typed.
  4828.  
  4829.         You will then be asked for a filespec to match.  This is the same as
  4830.         the filespec prompt in OPTION #0, Sub-option #4 - SHOW SELECTED FILES.
  4831.         Upon doing this, the label and directory contents will be read just
  4832.         like they would if they were about to be cataloged, but instead of
  4833.         adding them to your catalog, they will be shown directly on the screen
  4834.         in the same format as option #0, Sub-option #2 - Show Files For A
  4835.         Volume.  The archive scanning feature functions as normal throughout
  4836.         the program.
  4837.  
  4838.         Upon entering the search spec, scanning of the catalog will
  4839.         commence.  If you have status indicators turned on, a counter  will
  4840.         increment each time a matching file is found.  If at the and of the
  4841.         search, no files were found, an error message will be issued and you
  4842.         will be returned to the main menu.
  4843.  
  4844.         When the search has completed successfully, the file names will be
  4845.         shown alphabetically, along with the volume name, archive name, and
  4846.         other directory information for that file.
  4847.  
  4848.         For a list of options available, please see the section entitled
  4849.         "SCREEN REPORT OPTIONS AVAILABLE" in this manual.
  4850.  
  4851.  
  4852.  
  4853.         OPTION ESC:  EXIT TO DOS
  4854.  
  4855.         Select this option when you are finished with CATDISK to terminate its
  4856.         operation.  Upon exit, you will be returned to the DOS prompt.
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4882.  
  4883.                                       Page 73
  4884.  
  4885.  
  4886.  
  4887.                             APPENDIX A - THE SCROLL BAR
  4888.  
  4889.        When bringing up a screen report, you may have noticed a hatched bar on
  4890.        the right border of the screen with an inverse 'T' at the top of it and
  4891.        an inverse 'B' at the bottom.  This is a scroll bar, which indicates
  4892.        roughly where you are located along the full length of the current
  4893.        report.  Additionally, this feature will allow you to roughly position
  4894.        yourself in the report by hitting the <Grey Plus> and <Grey Minus>
  4895.        keys.  These keys will move you forward and backward respectively along
  4896.        this scroll bar.  These moves correspond to a move of one fifteenth of
  4897.        the total length of the report in the selected direction, as will be
  4898.        reflected in the page number which will be automatically set.
  4899.  
  4900.        The scroll bar position will also wrap from the top to the bottom if
  4901.        you are at the top and hit the <Grey Minus> key.  The reverse is also
  4902.        true for the <Grey Plus> key.
  4903.  
  4904.        In a long report, this represents a much nicer way of getting to, say,
  4905.        the files beginning with "R" without having to hit the <PgDn> key a
  4906.        hundred times.  Remember... the scroll bar is used to ROUGHLY position
  4907.        yourself among a group of files in a screen report.
  4908.  
  4909.        This scroll bar will appear in the point-and-shoot volume id selection
  4910.        screen as well.  Its functionality is much the same as that discussed
  4911.        above for reports.
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  4948.  
  4949.                                       Page 74
  4950.  
  4951.  
  4952.  
  4953.                            APPENDIX B - ARCHIVE SUPPORT
  4954.  
  4955.                  Version  File  Catalog
  4956.        Archiver  Tested   Ext.  Attrib.  Comments
  4957.        --------  -------  ----  -------  -------------------------------------
  4958.  
  4959.        PKZIP      2.04g   .ZIP   *ZIP    PKWare's current archiver that
  4960.                                          replaced PKARC and PKPAK.  CATDISK
  4961.                                          can read the file and main ZIP file
  4962.                                          comments and include them in your
  4963.                                          catalog.  Single disk ZIP files are
  4964.                                          supported, but the new disk-spanning
  4965.                                          ZIP files are not supported as yet.
  4966.                                          Maybe in a future release.
  4967.        ARJ        2.30    .ARJ   *ARJ    By Robert K. Jung.  Supported in the
  4968.                                          same manner as ZIP files.  We have
  4969.                                          verified that this release will also
  4970.                                          read files created by ARJ v2.39f BETA.
  4971.        LHA        2.13    .LZH   *LZH    By Haruyasu Yoshizaki.
  4972.        LARC       3.33    .LZS   *LZS    By K. Miki.  Same support as for LHA.
  4973.        LU        5th rev  .LBR   *LBR    Any version of the library utility
  4974.                                          supporting the 5th revision of the
  4975.                                          formal definition of this file format.
  4976.        ARC         5.30   .ARC   *ARC    Developed by System Enhancement
  4977.                                          Associates.  The idea was the
  4978.                                          predecessor of the archiving
  4979.                                          utilities that we know today.
  4980.        PKARC       3.50   .ARC   *ARC    PKWare's ARC-compatible archiver with
  4981.                                          several enhancements, including
  4982.                                          comments within the archive.  Because
  4983.                                          this is a non-standard extension of
  4984.                                          ARC's features, CATDISK does not
  4985.                                          support this feature.
  4986.        PKPAK       3.61   .ARC   *ARC    PKWare's PKARC renamed (for legal
  4987.                                          reasons).
  4988.        PAK         2.50   .PAK   *PAK    NoGate Consulting's archive utility
  4989.                                          - file format is compatible with ARC.
  4990.        ZOO         2.01   .ZOO   *ZOO    Comments contained in ZOO files may
  4991.                                          be read and included in your catalog.
  4992.        DWC        A5.01   .DWC   *DWC    By Dean W. Cooper.  Comments
  4993.                                          contained in DWC files may be read
  4994.                                          and included in your catalog.
  4995.        HYPER       2.50   .HYP   *HYP    By P. Sawatzki and K.P. Nischke
  4996.  
  4997.        Although not an archive file in the formal sense of the word, a GIF
  4998.        file (stands for Graphics Interchange Format) is a special file format
  4999.        that was developed by CompuServe in order to allow many different types
  5000.        of computers to be able to view a graphics image without having to
  5001.        modify the file itself.  GIF viewers are available on a wide variety of
  5002.        hardware platforms to allow you to look at the images contained within
  5003.        a GIF file.  These files can come in a very wide variety of resolutions
  5004.        and color combinations.  CATDISK can look into a GIF file and extract
  5005.        this resolution and color information and include it as a default
  5006.        comment for that GIF file.  For example, a picture that may be 640 by
  5007.        480 pixels with 256 colors would have a comment entry of
  5008.        "1024x768x256".
  5009.  
  5010.        Currently, the GIF87a and GIF89a are supported.
  5011.  
  5012.  
  5013.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5014.  
  5015.                                       Page 75
  5016.  
  5017.  
  5018.  
  5019.                 APPENDIX C - CATLOOK - COMMAND LINE LOOKUP UTILITY
  5020.  
  5021.        CATLOOK is a stand alone reporting utility provided with CATDISK.  It
  5022.        can come in handy on occasions when you either need to generate a quick
  5023.        and dirty report without having to run CATDISK itself, or when you need
  5024.        to generate a report after shelling out to DOS from within an
  5025.        application and there is not enough free memory left over to run
  5026.        CATDISK itself.  CATLOOK will run in 64K of free memory.
  5027.  
  5028.        A summary of the usage of CATLOOK follows:
  5029.  
  5030.        CATLOOK parameters (each must be separated by a slash or a space)
  5031.  
  5032.           /Ffilename - Use this file for the catalog (Default is CATDISK).
  5033.                        No space is allowed between the filename and the /F.
  5034.  
  5035.           /Rx        - Use report format x, where x is:
  5036.                        0 - Filenames+Statistics        1 - Filenames+Comments
  5037.                        2 - Subdirs+Filenames+Comments  3 - All Catalog Info.
  5038.           /S         - Show a summary report.
  5039.           /Vvolume   - Show files for a volume report for the volume label
  5040.                        specified.
  5041.           /Aarchive  - Show files for an archive report for the archive
  5042.                        specified.
  5043.           /Wpattern  - Show files for a DOS wildcard spec based on the pattern
  5044.                        given.
  5045.           /Ccomment  - Show files containing the comment substring specified.
  5046.           /Psdirpath - Show files residing in the specified subdirectory.  Do
  5047.                        not add the "\" or the "~" in the sdirpath.
  5048.           /U         - Show all files that are unique in the catalog file.
  5049.           /D         - Show all files that have duplicates in the catalog
  5050.                        file.
  5051.           /SIZE      - Use file size as an additional criteria in generating
  5052.                        the unique/duplicate file reports.
  5053.           /NT        - suppress the totals that are normally printed at the
  5054.                        end of CATLOOK's reports.
  5055.  
  5056.           /Ex        - Show everything sorted by x, where x is:
  5057.                        0 - File Name    1 - File Extension  2 - Subdirectory
  5058.                        3 - Volume Name  4 - Archive ID      5 - Comment
  5059.                        6 - Date/Time
  5060.  
  5061.        Due to the simplicity of this utility, the reports generated by CATLOOK
  5062.        are not paginated, but rather produced with one heading at the top of
  5063.        the report followed by the appropriate listings (equivalent to setting
  5064.        the number of lines per page equal to 0 in the configuration utility).
  5065.  
  5066.        If you are using report format 3 and are directing output to the
  5067.        printer, you must first have your printer set to compressed mode and
  5068.        that this mode must support at least 132 columns of output.
  5069.  
  5070.        The output from CATLOOK can be redirected to a printer or disk file by
  5071.        using the standard DOS method if I/O redirection.  For example:
  5072.  
  5073.          "CATLOOK /S >PRN" (without the quotes) - this will send a summary
  5074.                                                   report to your printer.
  5075.  
  5076.          "CATLOOK /S >LISTING.TXT" - this will send the summary report to a
  5077.                                      disk file called "LISTING.TXT".
  5078.  
  5079.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5080.  
  5081.                                       Page 76
  5082.  
  5083.  
  5084.  
  5085.                   APPENDIX D - CATMGR: CATDISK'S CATALOG MANAGER
  5086.  
  5087.        Before we even get into discussing this utility, we would like to
  5088.        stress that there is a possibility that a catalog file could get out of
  5089.        synch with the summary file under certain circumstances, particularly
  5090.        if a disk error or a disk-full condition occurs during certain
  5091.        operations.
  5092.  
  5093.        IF YOU USE THIS UTILITY, IT IS A GOOD IDEA TO MAKE A COPY OF YOUR DATA
  5094.        FILES BEFORE PROCEEDING.
  5095.  
  5096.        Also important to note is that ALL files being manipulated with this
  5097.        utility be kept in the SAME directory (if you specified a catalog file
  5098.        directory in the CDISKCFG utility, this is the one that should be used
  5099.        as CATMGR will refer tot his directory).  Do not have catalog set A on
  5100.        one disk or directory and catalog set B on a different disk or
  5101.        directory.
  5102.  
  5103.        In response to requests from the many users of CATDISK, we have
  5104.        developed a simple utility that will allow you to manipulate catalog
  5105.        entries among your various catalog files without having to uncatalog
  5106.        disks from one catalog and re-catalog them in another.  With CATMGR,
  5107.        you can copy records from one catalog to another (including a brand new
  5108.        catalog), move records from one catalog to another, delete multiple
  5109.        disks from a catalog in one pass and to change a disks volume id in the
  5110.        catalog file without affecting the volume label on the disk.
  5111.  
  5112.        CATMGR can have two catalog files loaded at one time.  The startup
  5113.        command for CATMGR is as follows:
  5114.  
  5115.        CATMGR CatalogFile1 CatalogFile2
  5116.  
  5117.        - where CatalogFile1 is the catalog file that you wish to be loaded on
  5118.          the left side of the screen and CatalogFile2 is the catalog file
  5119.         that you wish to be loaded on the right side of the screen. Both of
  5120.         these parameters are optional and you can specify one, both or none
  5121.         of them on the command line.
  5122.  
  5123.        The CATMGR screen is divided into three regions.  The upper left and
  5124.        right portions show information from the summary files from the two
  5125.        active catalog files, and the lower area makes up the instruction and
  5126.        message area.
  5127.  
  5128.        The general strategy with this utility is to tag the entries that you
  5129.        wish to copy, move or delete and then select the appropriate operation
  5130.        to perform.  For copying or moving catalog entries, the side of the
  5131.        screen on which the highlight bar resides is considered the source
  5132.        side, while the other side is considered the destination side.
  5133.  
  5134.        You can tag entries in one of two ways.  The first way is to highlight
  5135.        the desired entries by using the cursor keys and by pressing the
  5136.        <Space Bar>.  CATMGR will indicate that an entry is tagged when there
  5137.        is an arrow to the left of its volume name on the screen.
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5146.  
  5147.                                       Page 77
  5148.  
  5149.  
  5150.  
  5151.        You can move the highlight bar around the screen by using the following
  5152.        keys:
  5153.  
  5154.        <Up Arrow>    - Moves the highlight bar up one line if possible.
  5155.        <Down Arrow>  - Moves the highlight bar down one line if possible.
  5156.        <Left Arrow>  - Moves the highlight bar over to the last position on
  5157.                        the left side of the screen.
  5158.        <Right Arrow> - Moves the highlight bar over to the last position on
  5159.                        the right side of the screen.
  5160.        <PgUp>        - Moves the highlight bar up one screenful (16 lines) if
  5161.                        possible.
  5162.        <PgDn>        - Moves the highlight bar down one screenful (16 lines)
  5163.                        if possible.
  5164.        <Home>        - Moves the highlight bar to the top of the list.
  5165.        <End>         - Moves the highlight bar to the end of the list.
  5166.  
  5167.        The other way to tag entries is to do so in groups.  To bring up a list
  5168.        of tagging functions available, hit the <T> key at the main menu.
  5169.        CATMGR will bring up a list with the following functions that will
  5170.        operate on the side of the screen where the highlight bar currently
  5171.        resides:
  5172.  
  5173.          <A> - This will tag ALL of the entries.
  5174.  
  5175.          <C> - This will clear the tags of ALL of the entries.
  5176.  
  5177.          <S> - You will be prompted for a wildcard specification for all of
  5178.                the entries that you would like to be tagged.
  5179.  
  5180.          <U> - You will be prompted for a wildcard specification for all of
  5181.                the entries that you would like tags cleared.
  5182.  
  5183.          <I> - This will "flip" the tagged status of all entries.  This is
  5184.                useful if, for example, you wish to copy all but five of the
  5185.                 entries of a large catalog file to be copied to a new one.
  5186.            Simply tag the five that you do not wish to copy and then
  5187.            select this option to quickly tag the entries that you do wish
  5188.            to copy.
  5189.  
  5190.        <Esc> - Will return you to the main menu with no further action taken.
  5191.  
  5192.        Please note that for any of the tagging operations in any method, you
  5193.        cannot tag a volume name that exists on the other side of the screen
  5194.        because a copy or move operation will result in a duplicate volume
  5195.        showing in the target catalog.  When tagging an individual entry with
  5196.        the <Space Bar>, CATMGR will warn you of this.  When performing a group
  5197.        tagging function with the <T> options, all appropriate entries will be
  5198.        tagged with duplicates ignored.  There is no warning issued in this
  5199.        case.  Given this, it is advisable to load only one catalog file into
  5200.        memory if the only operations to be performed are deletions.
  5201.  
  5202.        To load a different or new catalog file into either half of the screen,
  5203.        just move the highlight bar to the desired side and press the <L> (Load
  5204.        New File) key.  CATMGR will ask you for the catalog file to be loaded,
  5205.        at which point you may enter the name portion of the catalog file only.
  5206.        Do not specify a file extension in this name; CATMGR will supply the
  5207.        necessary information at the appropriate time.  By hitting the <Esc>
  5208.        key, CATMGR will return you to the main menu with no further action
  5209.        taken.
  5210.  
  5211.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5212.  
  5213.                                       Page 78
  5214.  
  5215.  
  5216.  
  5217.        Upon successful entry of a catalog name, CATMGR will attempt to load
  5218.        the summary file for that catalog into memory.  If successful, those
  5219.        entries will immediately be displayed on your screen, and the catalog
  5220.        name will appear in the title area on its particular side of the
  5221.        screen.  Any previous tags that may have been set on that side of the
  5222.        screen will be cleared.
  5223.  
  5224.        If CATMGR is unable to find the catalog file, that side of the screen
  5225.        will be cleared, and it will be indicated that a new catalog file will
  5226.        be created in the event of a copy or move operation with that side as
  5227.        the destination side.  If you do not perform a copy or move operation
  5228.        into that catalog file, no catalog will be created for that name.
  5229.  
  5230.        Once you have a grouping of catalog entries tagged for an operation,
  5231.        here are the three that you can perform:
  5232.  
  5233.        <C>opy -   hit the <C> key to activate this function.  All tagged
  5234.                   catalog entries will be copied from the source catalog to
  5235.                   the destination catalog.  If an error occurs during this
  5236.                   phase, you will get an error message and the operation will
  5237.                   be aborted.
  5238.  
  5239.                   By far, the most common error will occur when your disk
  5240.                   becomes full.  During the copy process, CATMGR will read
  5241.                   information from both catalog files and merge them together
  5242.                   in a temporary new file.  At the end of the process, all
  5243.                   three files will exist at the same time, after which the old
  5244.                   file is deleted and the new one renamed.  The net result of
  5245.                   this is that you need free disk space equal to the size of
  5246.                   the target catalog file plus the cumulative size of the
  5247.                   number of records that will be copied from the source
  5248.                   catalog.
  5249.  
  5250.                   Once this operation is successful, the summary entries from
  5251.                   the source catalog will be copied into the destination
  5252.                   summary file.  This operation is done in memory, after which
  5253.                   the new summary file is written to disk.  As a general rule,
  5254.                   if there was enough room to update the catalog file, there
  5255.                   will certainly be enough room to create a new summary file.
  5256.  
  5257.                   If an error does occur, it was probably due to a physical
  5258.                   disk error.  If this does happen, your summary file will be
  5259.                   out of synch with its catalog file, and it is probably best
  5260.                   that you exit from CATMGR and restore a backup copy of the
  5261.                   target catalog set.
  5262.  
  5263.        <D>elete - This operation will delete tagged entries from the source
  5264.                   catalog file in a bulk operation, enabling you to perform an
  5265.                   efficient cleanup operation on your catalog file in one
  5266.                   pass, rather than the un-cataloging the entries one at a
  5267.                   time in the CATDISK program itself.
  5268.  
  5269.                   To perform the deletion(s), CATMGR will read through the
  5270.                   source file and build a new catalog file, minus the tagged
  5271.                   entries, of course.  If an error occurs while the new
  5272.                   catalog file is being built, CATMGR will abandon the
  5273.                   deletion operation and leave the original catalog file
  5274.                   intact.
  5275.  
  5276.  
  5277.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5278.  
  5279.                                       Page 79
  5280.  
  5281.  
  5282.  
  5283.                   As in the copy operation, the most common error will be a
  5284.                   disk full error for the similar reasons as the copy
  5285.                   operation.
  5286.  
  5287.                   Once the deletion operation on the catalog file is complete,
  5288.                   the summary file will be updated to reflect the deletions.
  5289.                   Again, the same considerations to a summary file update
  5290.                   apply to the summary update operation for deletions.
  5291.  
  5292.                   If you get an error while the summary file is being updated,
  5293.                   it is advisable that you restore a backup copy of that
  5294.                   catalog file.
  5295.  
  5296.        <M>ove   - this operation will move the entries from the source catalog
  5297.                   to the destination catalog.  It basically combines a copy
  5298.                   operation from source to destination, followed by a deletion
  5299.                   of the entries from the source.  The move operation is the
  5300.                   most convenient way to "split" a large catalog file into two
  5301.                   smaller ones, or to "merge" two smaller catalogs into one
  5302.                   large one.
  5303.  
  5304.  
  5305.       The last two options available are:
  5306.  
  5307.       <V> -   The <V> option on the main screen will allow you to change the
  5308.               volume id of the highlighted entry to one that you specify
  5309.               without having to insert that disk in a drive and re-catalog it
  5310.               under a different name.
  5311.  
  5312.               Due to the way that the disk list is maintained in CATMGR, you
  5313.               may only perform this operation if none of the files on the
  5314.               current side of the screen have been tagged.  If you have any
  5315.               entries tagged, you will get an error message.
  5316.  
  5317.               Once you have activated this operation, you will be prompted for
  5318.               a new volume id for the current entry.  If you enter a name that
  5319.               already exists in the current catalog file, you will get an
  5320.               error message.  If you enter the same name for the volume id as
  5321.               it had before, no action will take place.
  5322.  
  5323.               Once a valid volume id has been entered, the rest is automatic.
  5324.  
  5325.               If you inadvertently activated this option and do not wish to
  5326.               carry out any operation, hit <Esc> at the prompt and you will be
  5327.               returned to the main menu with no action taken.
  5328.  
  5329.       <Esc> - Finally, the last option available to you from the main menu is
  5330.               to exit from CATMGR to DOS.  This is done by pressing the <Esc>
  5331.               key.
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5344.  
  5345.                                       Page 80
  5346.  
  5347.  
  5348.  
  5349.             APPENDIX E - DISKFILL: CATDISK'S OPTIMAL DISK FILL UTILITY
  5350.  
  5351.        While CATDISK provides a way to manage the information that you have
  5352.        stored in a disk library, that still doesn't give us the excuse to
  5353.        waste disk space.  Unfortunately, copying files one at a time to a
  5354.        floppy and using our eyes to read the amount of free space left on the
  5355.        target disk and using our minds to scan the list of files to be
  5356.        offloaded and find the best file to fit that "hole" is tedious at best,
  5357.        especially if the list of files to be offloaded is large.
  5358.  
  5359.        We have developed a companion program to CATDISK called DISKFILL, which
  5360.        is included with CATDISK that addresses this problem.
  5361.  
  5362.        In a nutshell, DISKFILL has the ability to offload selected files from
  5363.        a single subdirectory at a time to a collection of disks (DISKFILL is
  5364.        primarily meant for use with floppies), and copying the files to them
  5365.        in such an order that the least amount of target disk space is wasted.
  5366.  
  5367.        DISKFILL also has the ability to move files (as opposed to copy files),
  5368.        and to delete groups of files as well.  Details on all three operations
  5369.        are discussed in their own sections in this appendix.
  5370.  
  5371.        As each disk is filled with files, DISKFILL can optionally call upon
  5372.        the CATDISK program to automatically catalog your disks as you go.
  5373.  
  5374.        DISKFILL can compare the files in your directory to those in an
  5375.        existing catalog to facilitate weeding out duplicate files BEFORE they
  5376.        get copied into your collection of files.
  5377.  
  5378.        4DOS/NDOS file descriptions are copied to the target disk with the
  5379.        files.  We strongly recommend that you use either 4DOS or NDOS to
  5380.        maintain comments right in the directory itself when you create or
  5381.        obtain the files that make up that directory.  That way, when you
  5382.        offload the files to diskettes and catalog them, there will be no
  5383.        guesswork in entering the file comments, as CATDISK will read them in
  5384.        as the disk gets cataloged.
  5385.  
  5386.        DISKFILL can also compare the list of files to be offloaded against a
  5387.        CATDISK catalog to allow intelligent recommendations of previously
  5388.        cataloged disks so that you may fill up those empty "holes" that may
  5389.        exist in your disk collection.
  5390.  
  5391.        DISKFILL can take one or more optional parameters as follows:
  5392.  
  5393.        DISKFILL parameters pattern
  5394.  
  5395.        where parameters may be one or more of the following:
  5396.  
  5397.        /Ffilename - filename is the name of the catalog file that you wish
  5398.                     DISKFILL to use for recommendations of previously
  5399.                     cataloged disks when offloading files to another media.
  5400.  
  5401.                     NOTE that there is no space between the /F and the
  5402.                     filename.  When specifying the filename, do NOT include a
  5403.                     path or file extension - DISKFILL will know where to look.
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5410.  
  5411.                                       Page 81
  5412.  
  5413.  
  5414.  
  5415.        /NOTAGALL  - Normally, DISKFILL automatically tags all files when
  5416.                     reading in a new subdirectory, as offloading all files is
  5417.                     the most common operation to perform.  By adding this
  5418.                     parameter to your command line when you start DISKFILL,
  5419.                     you can suppress this feature.
  5420.  
  5421.        /QUIET     - Silent operation.  Suppresses sound in DISKFILL.
  5422.  
  5423.        /N4        - Disables support for 4DOS's or NDOS's file descriptions.
  5424.                     If this option is NOT specified, DISKFILL will copy the
  5425.                     4DOS/NDOS file description over to the target diskette for
  5426.                     each file that has one, and any file called DESCRIPT.ION
  5427.                     will not be processed.
  5428.  
  5429.        /CATDISKD  - normally, when DISKFILL finishes copying or moving files
  5430.                     to the target floppy disk, it will, if requested, load
  5431.                     the standard version of CATDISK (CATDISK.EXE) to
  5432.                     automatically catalog the target floppy disk. Control then
  5433.                     returns to DISKFILL when the task is completed.  By adding
  5434.                     this option to the command line, DISKFILL will use the
  5435.                     DPMI-compliant protected mode version of CATDISK
  5436.                     (CATDISKD.EXE) instead.
  5437.  
  5438.        By default, the file list will be shown in the order that they appear
  5439.        in the directory.  You may control the order in which files appear with
  5440.        the following options.  If you specify any of these options, all
  5441.        subdirectories will be shown at the top of the file list, followed by
  5442.        the files themselves.
  5443.  
  5444.        /SF        - sorts the list alphabetically by filename.
  5445.        /SE        - sorts the list alphabetically by file extension.
  5446.        /SS        - sorts the list by file size.
  5447.        /SD        - sorts the list by file date/time.
  5448.  
  5449.        /RS        - by default, any specified sorts will be shown in ASCENDING
  5450.                     order.  You can reverse this by adding /RS to the command
  5451.                     line and cause the sort to be done in DECENDING order.
  5452.  
  5453.        NOTE that with these parameters shown above that, unlike the CATDISK
  5454.        program itself, they MUST be preceded by a slash.  This is due to the
  5455.        fact that the pattern mentioned below may contain a dash in its
  5456.        specification.
  5457.  
  5458.        pattern    - you may specify a wildcard filespec that you wish to be
  5459.                     included in a directory scan.  This filespec may be a
  5460.                     CATDISK enhanced filespec as documented in sub-option #4
  5461.                     of the reports and inquiries section of this user manual.
  5462.                     If no filespec is included on the command line, the
  5463.                     default, "*.*" is used.
  5464.  
  5465.                     NOTE that there is no slash or dash preceding the pattern.
  5466.  
  5467.        You may also put commonly used command line options in a DISKFILL
  5468.        environment variable using the DOS "SET" command.  This command (see
  5469.        examples below), may be placed in your AUTOEXEC.BAT file so that you
  5470.        will not need to remember which command line options to use to obtain
  5471.        your favorite setup, or for that matter, to type them!
  5472.  
  5473.        - example:  SET DISKFILL=/FCATDISK/NOTAGALL/QUIET
  5474.  
  5475.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5476.  
  5477.                                       Page 82
  5478.  
  5479.  
  5480.  
  5481.        You may run DISKFILL from any directory on your system.  That directory
  5482.        will be the initial subdirectory scanned on startup.  The subdirectory
  5483.        and filespec to match may be changed from within the program.
  5484.  
  5485.        DISKFILL has a capacity to hold 8000 files from a subdirectory.
  5486.        Once DISKFILL has loaded, it will scan the current directory and
  5487.        present a list of files that match the filespec given.  The procedure
  5488.        here is to tag the files that you wish to be manipulated and select an
  5489.        operation to perform on them.  As the initial or new directory is
  5490.        scanned, DISKFILL automatically selects ALL files for manipulation,
  5491.        unless you specified /NOTAGALL when you started DISKFILL, as this
  5492.        selection will undoubtedly be the most common.
  5493.  
  5494.        You can tag files in one of two ways.  The first way is to highlight
  5495.        the desired file by using the cursor keys and by pressing the
  5496.        <Space Bar>.  DISKFILL will indicate that a file is tagged when there
  5497.        is an arrow to the left of its filename name on the screen.
  5498.  
  5499.        You can move the highlight bar around the screen by using the following
  5500.        keys:
  5501.  
  5502.        <Up Arrow>    - Moves the highlight bar up one line if possible.
  5503.        <Down Arrow>  - Moves the highlight bar down one line if possible.
  5504.        <PgUp>        - Moves the highlight bar up one screenful (14 lines) if
  5505.                        possible.
  5506.        <PgDn>        - Moves the highlight bar down one screenful (14 lines)
  5507.                        if possible.
  5508.        <Home>        - Moves the highlight bar to the top of the list.
  5509.        <End>         - Moves the highlight bar to the end of the list.
  5510.  
  5511.  
  5512.        The other way to tag entries is to do so in groups.  To bring up a list
  5513.        of tagging functions available, hit the <T> key at the main menu.
  5514.        DISKFILL will bring up a list with the following functions:
  5515.  
  5516.          <A> - This will tag ALL of the files.
  5517.  
  5518.          <C> - This will clear the tags of ALL of the files.
  5519.  
  5520.          <S> - You will be prompted for a wildcard specification for all of
  5521.                the files that you would like to be tagged.
  5522.  
  5523.          <U> - You will be prompted for a wildcard specification for all of
  5524.                the files that you would like the tags cleared.
  5525.  
  5526.          <I> - This will "flip" the tagged status of all files.  This is
  5527.                useful if, for example, you wish to copy all but five of the
  5528.                files if a long list to be offloaded. Simply tag the five that
  5529.                you do not wish to copy and then select this option to quickly
  5530.                tag the entries that you do wish to copy.
  5531.  
  5532.          <F> - This will flip the tagged status of any files that DISKFILL
  5533.                finds as duplicates in the selected catalog file.  Normally,
  5534.                when offloading files to floppies and then cataloging them, you
  5535.                run a good risk of having duplicate files in your collection.
  5536.                Although CATDISK itself can point them out to you, it is still
  5537.                best to eliminate them before they get into your collection.
  5538.  
  5539.  
  5540.  
  5541.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5542.  
  5543.                                       Page 83
  5544.  
  5545.  
  5546.  
  5547.                Here are two strategies that you can use to "pre-process" a
  5548.                directory before offloading files "<M>ove" or "<C>opy":
  5549.  
  5550.                1) By activating this option with NO FILES FLAGGED, you can
  5551.                   then see which files are indeed duplicates, upon which you
  5552.                   can activate the <D>elete files option from the main menu.
  5553.                   Presto!  No more duplicate files.
  5554.  
  5555.                2) By activating this option with the files that you intend to
  5556.                   offload already flagged, you can have DISKFILL "un-tag" the
  5557.                   duplicate files that it finds.  You may then offload the
  5558.                   remaining files and examine the duplicate files left over.
  5559.  
  5560.                In order to use this option, you must have selected a catalog
  5561.                file to use either from the command line when you started
  5562.                DISKFILL, or from the main menu by using "<N>ew Catalog File".
  5563.  
  5564.                In order to determine whether or not a file is a duplicate,
  5565.                DISKFILL will use the filename and filesize.  When you hit <F>
  5566.                to activate this feature, DISKFILL will ask you if it should
  5567.                use the file date as an additional criteria.  You may answer
  5568.                <Y>es or <N>o to the prompt, or you may press <Esc> to abandon
  5569.                the operation.
  5570.  
  5571.                Once you have determined the criteria for DISKFILL to use, it
  5572.                will make a pass through your catalog file and compare the
  5573.                contents of the catalog file to the contents of the currently
  5574.                selected directory.  Each file that it finds as duplicate will
  5575.                have its flagged status flipped.  When the operation is
  5576.                complete, you will be returned to the file list.
  5577.  
  5578.        <Esc> - Will return you to the main menu with no further action taken.
  5579.  
  5580.  
  5581.        Other options available from the main menu are:
  5582.  
  5583.        <P> -     Change Pattern:  DISKFILL will prompt you for a new filespec
  5584.                  to match when scanning the directory.  This is handy if you
  5585.                  only wish to have a grouping of files from the current
  5586.                  subdirectory to be included in the point and shoot list.
  5587.                  Note that after the directory has been re-scanned, ALL files
  5588.                  will be tagged for manipulation.
  5589.  
  5590.        <S> -     Change Subdirectory:  DISKFILL will prompt you for a new
  5591.                  subdirectory to be scanned (the current pattern as noted at
  5592.                  the top of the screen will be used).  Note that after the
  5593.                  directory has been scanned, ALL files will be tagged for
  5594.                  manipulation.
  5595.  
  5596.        <N> -     New Catalog File: DISKFILL will prompt you for a new catalog
  5597.                  to be used in recommending disks from an existing catalog for
  5598.                  backfilling of files.  Do not specify a path or file
  5599.                  extension - DISKFILL will know where to look.  Hit <Esc> at
  5600.                  the prompt to leave the existing (or lack of) catalog
  5601.                  unchanged.  If you do enter a name, DISKFILL will attempt to
  5602.                  load that catalog.  If a problem occurs (eg. file not found
  5603.                  or error reading it), the setting will be cleared (i.e. no
  5604.                  catalog will be used).  If successful, that catalog will be
  5605.                  used in all recommendations and cataloging operations.
  5606.  
  5607.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5608.  
  5609.                                       Page 84
  5610.  
  5611.  
  5612.  
  5613.        <Enter> - If the highlight bar is currently pointing to a subdirectory
  5614.                  accessible directly from the current directory, you may press
  5615.                  <Enter> to switch to that subdirectory.  If you are pointing
  5616.                  to <PARENT DIR> and hit <Enter>, you will move down one level
  5617.                  in the disk's subdirectory tree.
  5618.  
  5619.                  By traversing the directory tree in this manner, it is
  5620.                  possible to quickly move from one directory to another in a
  5621.                  point and shoot manner.  It may be quicker to use the <S>
  5622.                  option to move directly to a subdirectory that you enter at a
  5623.                  prompt in some circumstances.  If you wish to switch to
  5624.                  another disk drive, you must use the <S> option.
  5625.  
  5626.  
  5627.        DISKFILL currently has three operations that you can perform on the
  5628.        tagged files:
  5629.  
  5630.        <C> - Copy:  When this option is selected, DISKFILL will ask you for
  5631.                     the drive of the target disk(s) that will received the
  5632.                     tagged files.  Typically, this will be drive A: or drive
  5633.                     B:, but we have allowed any available drive letter in your
  5634.                     system due to the fact that there may be an external
  5635.                     floppy disk using a device driver that is available.  Hit
  5636.                     <Esc> to abandon the operation.
  5637.  
  5638.                     While on the topic of the target disk, you may change the
  5639.                     target disk at any prompt while in the copy or move
  5640.                     function (except at the disk recommendation prompt) by
  5641.                     pressing <N> for New Target Disk.
  5642.  
  5643.                     Once you have selected the target drive, DISKFILL will ask
  5644.                     you if you would like to catalog each disk after it has
  5645.                     received more files.  This prompt requires a simple YES or
  5646.                     NO answer, which can be indicated by pressing "Y" for YES
  5647.                     or "N" for NO.  You may press <Esc> at this prompt to
  5648.                     abandon the operation.
  5649.  
  5650.                     DISKFILL will then prompt you to insert a disk in the
  5651.                     target drive.  If you do not wish to continue with the
  5652.                     operation, hit <Esc> to return to the main menu.
  5653.  
  5654.                     You may also press the <S> key at the prompt to shell out
  5655.                     to DOS.  This is handy if you need to check something
  5656.                     outside of the DISKFILL program before proceeding.
  5657.  
  5658.                     If you have instructed DISKFILL to use a catalog file for
  5659.                     the purposes of recommending disks for "backfilling"
  5660.                     previously cataloged disks, you may press <R> at this
  5661.                     prompt.
  5662.  
  5663.                     DISKFILL will then compare the list of files that need to
  5664.                     be copied or moved with the entries in the selected
  5665.                     catalog and will recommend a disk to use for accepting
  5666.                     more files.  The program will attempt to recommend disks
  5667.                     such that the ones with the least amount of free space
  5668.                     (those are the most difficult to fill later) are used
  5669.                     first.
  5670.  
  5671.  
  5672.  
  5673.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5674.  
  5675.                                       Page 85
  5676.  
  5677.  
  5678.  
  5679.                     If you have a catalog containing mixed media (hard drives,
  5680.                     two different floppy drive sizes on the A: and B: drives,
  5681.                     etc.), DISKFILL is currently not able to differentiate
  5682.                     between them, so it may be possible for it to suggest a
  5683.                     5-1/4" diskette when you are copying to 3.5" diskettes, or
  5684.                     even you hard drive.  You may also have cataloged program
  5685.                     disks that you have purchased, to which you do not
  5686.                     necessarily want to copy files.  If DISKFILL recommends
  5687.                     such a disk, sit the <S> key at the recommendation prompt
  5688.                     to "Squelch" that disk and not use it for any further
  5689.                     recommendations.  DISKFILL will then recommend another
  5690.                     disk for use.
  5691.  
  5692.                     NOTE: If you need to "re-activate" those disks that have
  5693.                     been "squelched" for another copy process, simply load
  5694.                     that summary file from the main menu before performing any
  5695.                     other copy or move operations.
  5696.  
  5697.                     NOTE: Any disks whose volume labels match any of the
  5698.                     "volumespecs" set via the configuration program,
  5699.                     CDISKCFG.EXE, will be automatically "squelched".  If you
  5700.                     these disks re-activated, you will need to go back into
  5701.                     the configuration program and modify the list.
  5702.  
  5703.                     Once you have the desired disk inserted, and are ready to
  5704.                     copy files to it, hit any other key to proceed.
  5705.                     The prompt containing all the above mentioned options
  5706.                     will appear before each disk necessary to complete the
  5707.                     operation is to be inserted.
  5708.  
  5709.                     Before DISKFILL begins to copy files to each disk, it will
  5710.                     examine the disk to determine capacity and to check to see
  5711.                     if any files or sub-directories are present on the disk.
  5712.                     If a disk error occurs at this stage, DISKFILL will assume
  5713.                     that the disk is not formatted and will bring up a message
  5714.                     indicating that it thinks that the disk is not formatted.
  5715.  
  5716.                     You have three options at this point:
  5717.  
  5718.                     1) You may hit <S> to shell out to DOS to either examine
  5719.                        the disk, or to invoke your favorite program to
  5720.                        facilitate formatting that diskette.  We have not built
  5721.                        in the facility to load any particular disk formatting
  5722.                        software, as there are many alternatives to the DOS
  5723.                        format command, and the selection of a given program is
  5724.                        a matter of personal preference.  This also leaves open
  5725.                        the possibility of using a disk formatting program that
  5726.                        has the ability to format more capacity on a disk than
  5727.                        normal.
  5728.  
  5729.                        When you are ready to continue with the copy operation
  5730.                        after shelling out to DOS, type "EXIT" and hit <Enter>
  5731.                        to return back to the prompt.
  5732.  
  5733.                     2) You may hit <Esc> to abort the copy operation and
  5734.                        return to the main menu.
  5735.  
  5736.                     3) You may hit any other key to try a new diskette, at
  5737.                        which time the disk determination will be repeated.
  5738.  
  5739.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5740.  
  5741.                                       Page 86
  5742.  
  5743.  
  5744.  
  5745.                     If the target disk has files on it, you will be presented
  5746.                     with another set of options that will allow you to make a
  5747.                     decision on what to do next:
  5748.  
  5749.                     1) You may hit <V> to view the directory of the target
  5750.                        disk to verify that it is the one that you intended to
  5751.                        insert in the drive.  The DOS "DIR/P" command will be
  5752.                        issued.
  5753.  
  5754.                     2) You may hit <S> to shell to DOS.  This option is
  5755.                        available to allow you to examine the situation more
  5756.                        closely, perhaps to examine the directory of the disk
  5757.                        and see if you have inserted the correct diskette.
  5758.                        When you return from the DOS shell, you will be left at
  5759.                        this prompt from which you may take appropriate action.
  5760.  
  5761.                     3) You may press <E> to have DISKFILL erase all visible
  5762.                        files and subdirectories from that disk before
  5763.                        proceeding with the copy operation.
  5764.  
  5765.                        IF YOU ARE USING A TARGET DRIVE OTHER THAN A: or B:,
  5766.                        EXERCISE THIS OPTION WITH EXTREME CAUTION.  IF THE
  5767.                        TARGET DRIVE HAPPENS TO BE A HARD DISK, ALL VISIBLE
  5768.                        FILES AND SUBDIRECTORIES WILL BE ERASED.  YOU HAVE BEEN
  5769.                        WARNED!
  5770.  
  5771.                     4) You may press <T> to try another diskette.  You will
  5772.                        then be returned to the disk insertion prompt.
  5773.  
  5774.                     5) You may press <Esc> to Abort the copy operation
  5775.                        altogether and return to the main menu.
  5776.  
  5777.                     6) You may press any other key to continue on with the
  5778.                        copy operation.  DISKFILL will then add files to those
  5779.                        that already exist on the target diskette as available
  5780.                        space allows.
  5781.  
  5782.                     Once all is ready, DISKFILL will proceed to copy files to
  5783.                     the target diskette.  As each file is copied, it will be
  5784.                     highlighted in the list and a progress indicator will
  5785.                     appear in the instruction area of the screen keeping you
  5786.                     informed of the progress of the copy.  DISKFILL will
  5787.                     buffer as much of the source file into memory as it can
  5788.                     before writing it out to the target diskette in order to
  5789.                     facilitate speed.
  5790.  
  5791.                     As DISKFILL copies files, an indicator at the bottom of
  5792.                     the screen will indicate how much of the read and write
  5793.                     operations are complete.  The indicator beside each status
  5794.                     indicator that is flashing will indicate what DISKFILL is
  5795.                     currently doing.
  5796.  
  5797.                     If you added the /4DOS or /NDOS command line option when
  5798.                     you started DISKFILL, it will, upon copying each file to
  5799.                     the target disk, check to see if the file just copied has
  5800.                     a 4DOS/NDOS file description.  If so, that file
  5801.                     description will be copied over to the target disk if
  5802.                     there is enough room to accommodate it.  It is possible
  5803.                     that disk space may be completely filled and the hidden
  5804.  
  5805.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5806.  
  5807.                                       Page 87
  5808.  
  5809.  
  5810.  
  5811.                     file that 4DOS or NDOS maintains cannot be expanded.  If
  5812.                     this occurs, the description will not appear in the
  5813.                     directory of the target disk, even though the file was
  5814.                     successfully copied.  This behavior is consistent with
  5815.                     that of 4DOS and NDOS.
  5816.  
  5817.                     As each file is successfully copied to the target, it will
  5818.                     be "un-tagged" in the file list.  This way, if the copy
  5819.                     process is interrupted or aborted for any reason, you can
  5820.                     effectively pick up where you left off, as the tagged
  5821.                     files will be those that were not copied.
  5822.  
  5823.                     The capacity left over on the target disk will be updated
  5824.                     as each file is copied to it.  Additionally, the
  5825.                     statistics on the right side of the screen will indicate
  5826.                     how many files have yet to be copied.
  5827.                     If a disk error occurs when copying a file to the target,
  5828.                     that copy will be aborted.  DISKFILL will make an attempt
  5829.                     to remove that file from the target disk, although this
  5830.                     cannot be guaranteed.  The file that was being copied at
  5831.                     the time of the error will remain in the "hit list" to be
  5832.                     copied to a subsequent disk.  You will then be returned to
  5833.                     the prompt for a new disk with which to continue the copy
  5834.                     operation.
  5835.  
  5836.                     It may be advisable to shell out to DOS at this point with
  5837.                     the <S> command to check the disk and perhaps run a
  5838.                     diagnostic program on the target disk in order to map out
  5839.                     any bad areas of the disk.  If this proves to be the cause
  5840.                     of the error, you may be able to continue the copy
  5841.                     operation with that disk.
  5842.  
  5843.                     When DISKFILL has determined that no more files from the
  5844.                     selected list will fit on the target disk, it will do one
  5845.                     of two things:
  5846.  
  5847.                     1) If you indicated that you would like each disk to be
  5848.                        cataloged, DISKFILL will attempt to load CATDISK and
  5849.                        tell it to catalog the disk.
  5850.  
  5851.                        Any command line parameters in the CATDISK environment
  5852.                        variable (see the section on starting CATDISK for
  5853.                        details) will also be in effect for this operation.
  5854.                        When the operation is complete, you will be returned to
  5855.                        the disk insertion prompt where you may continue on
  5856.                        with a new diskette, or abort the operation right
  5857.                        there.
  5858.  
  5859.                        The catalog used in the operation will be determined in
  5860.                        the following order of priority:
  5861.  
  5862.                        i)   If you specified a catalog to be used for
  5863.                             recommendations for backfilling disks, that
  5864.                             catalog will be used in the catalog operation.
  5865.  
  5866.                        ii)  If the above is not the case, any catalog name
  5867.                             specified in the CATDISK environment variable (see
  5868.                             STARTING CATDISK in this manual) will be used.
  5869.  
  5870.  
  5871.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5872.  
  5873.                                       Page 88
  5874.  
  5875.  
  5876.  
  5877.                        iii) If neither of the above two are true, the default
  5878.                             catalog name "CATDISK" will be used.
  5879.  
  5880.  
  5881.                        In order for this operation to be successful, two
  5882.                        criteria must be met:
  5883.  
  5884.                        i)  The program CATDISK.EXE must be present in either
  5885.                            the current directory or in a subdirectory
  5886.                            specified in your DOS PATH and
  5887.  
  5888.                        ii) There must be enough memory available (DISKFILL
  5889.                            remains in memory while CATDISK does its thing) to
  5890.                            load CATDISK and complete the function.
  5891.  
  5892.  
  5893.                     If one or both of these criteria are not met, the
  5894.                     cataloging operation will not take place, and you will
  5895.                     be notified of the error.
  5896.  
  5897.                     2) If you indicated that you would NOT like each disk to
  5898.                        be cataloged, you will be returned to the disk
  5899.                        insertion prompt where you may continue on with a new
  5900.                        diskette, or abort the operation right there.
  5901.  
  5902.                     When all selected files have been copied to the target
  5903.                     directory, you will automatically be returned to the main
  5904.                     menu where the updated file list will be displayed.  If
  5905.                     all went well, there should be no more files tagged.
  5906.  
  5907.  
  5908.  
  5909.                                          IMPORTANT NOTES
  5910.  
  5911.                     DISKFILL will work best when there is a mix of large and
  5912.                     small files available for copying to the target disk(s),
  5913.                     as DISKFILL will be able to use the smaller files to fill
  5914.                     in the holes left over by the larger files.
  5915.  
  5916.                     It is not necessary to use disks of the same capacity
  5917.                     throughout an entire copy operation.  For example, in a
  5918.                     high capacity 3.5" drive, you could use a mix of 1.44Mb
  5919.                     and 720K floppies.  DISKFILL will copy files to it as the
  5920.                     capacity of each inserted disk allows.
  5921.  
  5922.                     If you have one or several files that are too big to fit
  5923.                     on a target drive, the insert disk prompt will simply be
  5924.                     repeated over and over again until you abort, as DISKFILL
  5925.                     is a very patient program and will wait until a suitable
  5926.                     disk is inserted in the drive.
  5927.  
  5928.                     If you have been using low density media, you may need to
  5929.                     switch to a higher capacity disk format in order to
  5930.                     accommodate the file.
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  5938.  
  5939.                                       Page 89
  5940.  
  5941.  
  5942.  
  5943.                     If you have a file that will not fit on a disk of any
  5944.                     capacity, DISKFILL will not be able to offload it.  If the
  5945.                     file is not compressed, you may wish to use one of the
  5946.                     many archive utilities supported by CATDISK to compress
  5947.                     the file to a size that may fit on a target disk, or
  5948.                     alternatively, you may wish to use a file split/merge
  5949.                     utility to break the file down into smaller, more
  5950.                     manageable sub-files.
  5951.  
  5952.        <M> - Move:  The MOVE operation works exactly like the copy operation
  5953.                     except that each file being offloaded is erased after the
  5954.                     copy operation is complete.  If a disk error occurs during
  5955.                     the copying part of the operation, the file involved is
  5956.                     left intact in the source directory where an attempt can
  5957.                     be made to move it to another disk later on in the
  5958.                     operation.
  5959.  
  5960.                     THE MOVE OPERATION IS THE PREFERRED METHOD OF OFFLOADING
  5961.                     FILES TO FLOPPIES.  It is also safe due to the fact that
  5962.                     the only time that the source file is erased is when it
  5963.                     has been successfully copied to the target disk.
  5964.  
  5965.        <D> - Delete:  This operation will quickly delete all selected files
  5966.                       from the source directory.  Once a file has been
  5967.                       deleted, DISKFILL cannot recover it, although it is
  5968.                       possible to use one of the many file unerase utilities
  5969.                       on the market to get the file back.
  5970.  
  5971.                       Due to the potential severity of using this function,
  5972.                       you will be asked for verification before continuing.
  5973.  
  5974.        NOTE:  With the move and delete operations, DISKFILL will not be able
  5975.               to erase a file marked "READ-ONLY".
  5976.  
  5977.  
  5978.  
  5979.  
  5980.  
  5981.  
  5982.  
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.  
  5989.  
  5990.  
  5991.  
  5992.  
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.  
  6003.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6004.  
  6005.                                       Page 90
  6006.  
  6007.  
  6008.  
  6009.                APPENDIX F - DUPCLEAN: CATDISK'S FILE CLEANUP UTILITY
  6010.  
  6011.        As your software collection grows, you will undoubtedly wind up with
  6012.        many duplicate files in your collection.  It is also common, especially
  6013.        when building a shareware collection from BBS systems, to have many
  6014.        different versions of the same program.  When this is the case, the
  6015.        filename(s) will usually start with the same characters, followed by
  6016.        numeric digits and dashes to indicate the version.  In many cases, it
  6017.        is desirable to have the latest version or two of a program, but not
  6018.        the older versions.
  6019.  
  6020.        DUPCLEAN provides a simple mechanism to enable you to weed out the
  6021.        duplicate files and the redundant old versions based on the contents of
  6022.        your catalog.  The only restrictions are that DUPCLEAN does not have the
  6023.        ability to erase files from within archive files and that any files
  6024.        affected must either reside in the root directory or in the next level
  6025.        (eg. A:\ or A:\CATDISK).
  6026.  
  6027.        A short discussion on some of the various items on the DUPCLEAN screen
  6028.        is in order before we continue.
  6029.  
  6030.        Item                 Description
  6031.        -------------------  --------------------------------------------------
  6032.  
  6033.        Base Chars For Dups  DUPCLEAN will examine this number of characters in
  6034.                             the base part of the filename when determining
  6035.                             what files to include in the list of files for
  6036.                             selection.
  6037.  
  6038.        Pattern              Any files must match this pattern in order to be
  6039.                             considered for inclusion in the list of files for
  6040.                             selection.
  6041.  
  6042.        Catalog              Use this catalog for searching for duplicates.
  6043.  
  6044.  
  6045.        When you start DUPCLEAN, you may specify various command line options
  6046.        that will initialize various settings within the program.  Options may
  6047.        be separated by a slash, dash or a space.
  6048.  
  6049.        They are as follows:
  6050.  
  6051.          /FFilename  - Uses this catalog file for searching.  Note that no
  6052.                        space is permitted between the /F and the catalog
  6053.                        filename.
  6054.  
  6055.          /Bbasechars - initialize the setting for the base chars for dups.
  6056.                        Default is 8.
  6057.  
  6058.          /Ppattern   - initialize the setting for the pattern.  Default is *.*
  6059.  
  6060.          /VERSIONS   - normally, DUPCLEAN only examines the first number of
  6061.                        characters as defined by the basechars setting and
  6062.                        ignores the rest.  If this option is activated (you can
  6063.                        also activate it from within the program), DUPCLEAN
  6064.                        will examine the rest of the characters, which must be
  6065.                        either numeric, a space, dash or underscore.
  6066.  
  6067.          /QUIET      - Quiet operation (eliminate sound in the program)
  6068.  
  6069.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6070.  
  6071.                                       Page 91
  6072.  
  6073.  
  6074.  
  6075.          /ND         - Shows dates as YYYY-MM-DD. Default is MMM DD,YYYY.
  6076.  
  6077.          /CATDISKD   - when DUPCLEAN needs to catalog a disk, use CATDISKD.EXE
  6078.                        instead of CATDISK.EXE (for larger catalog files).
  6079.  
  6080.  
  6081.        Upon startup, DUPCLEAN will scan the catalog file, if specified at
  6082.        startup or through the CDISKCFG program for any files that match the
  6083.        specs as defined at startup.  These files are then shown in a
  6084.        scrollable list below.
  6085.  
  6086.        The strategy is to first get the list showing the desired file list.
  6087.        You may control what gets into the list by changing the three items at
  6088.        the top of the screen to the desired settings.  Here are the three
  6089.        options that control these items:
  6090.  
  6091.        <B> - Change Base Characters For Duplicates
  6092.  
  6093.              Enter the number of characters from the start of the filename that
  6094.              you would like DUPCLEAN to use for comparison.  If, for example,
  6095.              you enter 5 for this setting, DUPCLEAN will match any files whose
  6096.              first 5 characters are the same.
  6097.  
  6098.              When you change this setting to a value less then 8, DUPCLEAN will
  6099.              also ask you if you want to match only numeric characters after
  6100.              the base characters have been analyzed.  If you answer YES,
  6101.              DUPCLEAN will act in the same manner as if you had added the
  6102.              /VERSIONS option to the command line at startup.  If you answer
  6103.              NO, any characters after the number of base characters will be
  6104.              disregarded.
  6105.  
  6106.        <P> - Change Pattern To Match
  6107.  
  6108.              Enter the file pattern that any files MUST match in order to be
  6109.              included in the list.  You may use the CATDISK enhanced wildcard
  6110.              matching specifications supported by all programs in this package.
  6111.  
  6112.              If the base characters to match setting is less then 8, DUPCLEAN
  6113.              will prompt you for the numeric character match as mentioned
  6114.              above.
  6115.  
  6116.        <A> - Change Active Catalog File
  6117.  
  6118.              Enter the name of the catalog file (WITHOUT the subdirectory or
  6119.              file extension included) that you wish DUPCLEAN to use in creating
  6120.              the point & shoot list of duplicates.
  6121.  
  6122.              Again, if the base characters to match setting is less then 8,
  6123.              DUPCLEAN will prompt you for the numeric character match as
  6124.              mentioned above.
  6125.  
  6126.  
  6127.        While these three options give you the ability to get duplicate files
  6128.        showing on your screen for selection, you should realize that there will
  6129.        be many cases that, in order to eliminate ALL duplicate or redundant
  6130.        files, you will have to make multiple passes through your catalog with
  6131.        different settings; in particular, the base characters to match setting.
  6132.  
  6133.  
  6134.  
  6135.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6136.  
  6137.                                       Page 92
  6138.  
  6139.  
  6140.  
  6141.        For example, you may have files such as:
  6142.  
  6143.        ABC100.ZIP, ABC110.ZIP, ABC120.ZIP, ABC200.ZIP, etc.
  6144.  
  6145.        and
  6146.  
  6147.        CDISK600.ZIP, CDISK610.ZIP, CDISK620.ZIP, CDISK700.ZIP, etc.
  6148.  
  6149.        With the base characters set at 5 while matching only numeric characters
  6150.        after that, the second list will (possibly among other files) and with
  6151.        the base characters set at 3 with numeric character matching activated,
  6152.        the first list will show up.
  6153.  
  6154.  
  6155.        Once you have the desired file list showing on the screen, you are now
  6156.        ready to select the files that you would like to be erased from your
  6157.        file collection by tagging them.
  6158.  
  6159.        You can tag files in one of two ways.  The first way is to highlight
  6160.        the desired file by using the cursor keys and by pressing the
  6161.        <Space Bar>.  DISKFILL will indicate that a file is tagged when there
  6162.        is an arrow to the left of its filename name on the screen.
  6163.  
  6164.        Move the highlight bar around the screen by using the following keys:
  6165.  
  6166.        <Up Arrow>    - Moves the highlight bar up one line if possible.
  6167.        <Down Arrow>  - Moves the highlight bar down one line if possible.
  6168.        <PgUp>        - Moves the highlight bar up one screenful (12 lines) if
  6169.                        possible.
  6170.        <PgDn>        - Moves the highlight bar down one screenful (12 lines)
  6171.                        if possible.
  6172.        <Home>        - Moves the highlight bar to the top of the list.
  6173.        <End>         - Moves the highlight bar to the end of the list.
  6174.  
  6175.        You may use the scroll bar to navigate through the list in the same way
  6176.        as CATDISK's screen-based reports, except that here, each position on
  6177.        the scroll bar represents 1/12 of the total length of the list.
  6178.  
  6179.        The other way to tag entries is to do so in groups.  To bring up a list
  6180.        of tagging functions available, hit the <T> key at the main menu.
  6181.        DISKFILL will bring up a list with the following functions:
  6182.  
  6183.          <A> - This will tag ALL of the files.
  6184.  
  6185.          <C> - This will clear the tags of ALL of the files.
  6186.  
  6187.          <S> - You will be prompted for a wildcard specification for all of
  6188.                the files that you would like to be tagged.
  6189.  
  6190.          <U> - You will be prompted for a wildcard specification for all of
  6191.                the files that you would like the tags cleared.
  6192.  
  6193.          <I> - This will "flip" the tagged status of all files.  This is
  6194.                useful if, for example, you wish to erase all but five of the
  6195.                files if a long list. Simply tag the five that you do not wish
  6196.                to erase and then select this option to quickly tag the entries
  6197.                that you do wish to erase.
  6198.  
  6199.        <Esc> - Will return you to the main menu with no further action taken.
  6200.  
  6201.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6202.  
  6203.                                       Page 93
  6204.  
  6205.  
  6206.  
  6207.        When you have the desired files selected, and are ready to erase them,
  6208.        hit <Alt>-<E> to begin the procedure.
  6209.  
  6210.        The first thing that DUPCLEAN will do is ask you which drive should be
  6211.        used for deletions (commonly A: or B:, but any drive could be used).
  6212.        While the drive that you specify will be the initial drive used for
  6213.        deletions, you may change it at any "Insert Disk xxx" prompt to another
  6214.        disk drive if you so desire (eg. when a mix of files from 3.5" and 5.25"
  6215.        disks are tagged for deletion).
  6216.  
  6217.        You will then be asked if you would like each disk to be cataloged as
  6218.        they are processed.  Answering YES to this prompt is desirable, as it
  6219.        will ensure that your catalog file is consistent with your disk
  6220.        collection.
  6221.  
  6222.        Note that in order for this option to work, you must have CATDISK.EXE or
  6223.        CATDISKD.EXE (depending on which one you have instructed DUPCLEAN to
  6224.        use) present in either the current directory or somewhere along the DOS
  6225.        path.  There must also be sufficient free memory to load CATDISK with
  6226.        its configured memory settings so that it can read the disk and process
  6227.        your catalog file.
  6228.  
  6229.        While DUPCLEAN doesn't use much memory itself, if you have CATDISK set
  6230.        to the limits of your computer's memory, you may not have sufficient
  6231.        free memory to perform the task.  If this is the case, and you are using
  6232.        CATDISK.EXE and you have sufficient available extended memory, we would
  6233.        recommend that you instruct DUPCLEAN to use CATDISKD.EXE instead.
  6234.  
  6235.        When you have answered the prompts, DUPCLEAN will prompt you for the
  6236.        first disk that it would like inserted in the disk drive.  To the right
  6237.        of the prompt will be the name of the file that will be erased.
  6238.  
  6239.        You have several options available to you at this time:
  6240.  
  6241.        <T>   - Change the target disk to another drive letter.
  6242.  
  6243.        <F>   - Forget this file.  DUPCLEAN will skip the file and continue on
  6244.                to the next one.
  6245.  
  6246.        <D>   - View the target disk's directory.  May be useful to diagnose any
  6247.                problems.
  6248.  
  6249.        <S>   - Shell to DOS.  May also be useful in diagnosing any problems.
  6250.  
  6251.        <Esc> - Stop the erase operation altogether.
  6252.  
  6253.        Hit any other key to continue with the erase operation.  DUPCLEAN will
  6254.        then erase each tagged file that resides on the disk.
  6255.  
  6256.  
  6257.        Note that DUPCLEAN makes a complete pass through the list for each disk
  6258.        involved in the process.  This is to minimize disk swapping on your
  6259.        part.
  6260.  
  6261.  
  6262.  
  6263.  
  6264.  
  6265.  
  6266.  
  6267.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6268.  
  6269.                                       Page 94
  6270.  
  6271.  
  6272.  
  6273.        If, for example, you have:
  6274.  
  6275.          FILE A on DISK 1
  6276.          FILE B on DISK 2
  6277.          FILE C on DISK 1
  6278.             and so on
  6279.  
  6280.        DUPCLEAN will prompt you for DISK 1 and erase FILE A and FILE C in the
  6281.        same pass.  It will then continue with DISK 2 and so on until the
  6282.        process is completed.
  6283.  
  6284.        As a new pass begins and a new disk is required, you will be prompted
  6285.        for it as above until all tagged files have been deleted (or skipped).
  6286.  
  6287.  
  6288.        When you are finished using DUPCLEAN, hit <Esc> to leave the program.
  6289.  
  6290.  
  6291.  
  6292.  
  6293.  
  6294.  
  6295.  
  6296.  
  6297.  
  6298.  
  6299.  
  6300.  
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6334.  
  6335.                                       Page 95
  6336.  
  6337.  
  6338.  
  6339.                   APPENDIX G - REGISTRATION, SUPPORT AND UPDATES
  6340.  
  6341.        As said in the introduction, CATDISK is shareware and should be
  6342.        registered if you are using it and/or would like to be able to obtain
  6343.        product support and upgrades.  If you are paying by check (business or
  6344.        personal) or money order, please be sure that it is drawn on either a
  6345.        Canadian or US bank (we can handle either).  If you wish to use your
  6346.        VISA card to register, you may either FAX the registration form to us,
  6347.        register online on our support BBS, The Shareware Connection, or
  6348.        register directly with us by voice on our sales/support line.
  6349.  
  6350.        When new versions of CATDISK are released, we send out notices to
  6351.        registered users informing them of the new release's availability.
  6352.        Once you are registered for one CATDISK release, you are considered to
  6353.        be registered for all future CATDISK releases, whether you receive them
  6354.        directly from us or not.  If you are a registered CATDISK user and
  6355.        would like to order the latest from us on disk, simply select one of
  6356.        the disk-based registration options and DEDUCT THE BASE REGISTRATION
  6357.        FEE FROM THAT.
  6358.  
  6359.        Note that we confirm all registrations in writing and provide a simple
  6360.        procedure to eliminate the shareware intro screens present in the
  6361.        program.
  6362.  
  6363.        When registering CATDISK, by mail or FAX, please use the registration
  6364.        form that is available with this program.  This registration form
  6365.        includes all pricing information for CATDISK.  The pricing on the
  6366.        registration form is guaranteed for a period of one year from the
  6367.        release date of this package (see the title page for the release date).
  6368.        If, for some reason, you do not have a registration form or the one
  6369.        year period has expired, please obtain a current registration form from
  6370.        our support BBS or contact us by phone or FAX (numbers listed below) to
  6371.        obtain the current pricing information.
  6372.  
  6373.        You will note on the registration form that we have broken out the base
  6374.        registration fee from all disk upgrade and BBS support options. This is
  6375.        mainly to accommodate those who are in a situation where they have a
  6376.        reliable source of obtaining new CATDISK releases, or those who are
  6377.        content with the version that they are using and have no desire to
  6378.        upgrade.  By breaking out all options separately, you have the
  6379.        opportunity to put together a registration/upgrade/support package that
  6380.        best suits you.
  6381.  
  6382.        Note that in the case of disk-based upgrades, we ship CATDISK on either
  6383.        one 3.5" 720K diskette, one 1.2Mb 5.25" diskette or on two 360K 5.25"
  6384.        disks.
  6385.  
  6386.        Support Location              Details
  6387.        ----------------------------  -----------------------------------------
  6388.  
  6389.        Sales/Support Voice Line      (519) 570-3523      SEE NOTE #1 BELOW.
  6390.        FAX (Orders & Support)        (519) 884-4887
  6391.        The Shareware Connection BBS  (519) 570-4132 (16,800 USR HST DS Modem).
  6392.                                                     The Home of CATDISK.
  6393.                                                          SEE NOTE #3 BELOW.
  6394.        CompuServe ID - 73307,333
  6395.  
  6396.  
  6397.  
  6398.  
  6399.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6400.  
  6401.                                       Page 96
  6402.  
  6403.  
  6404.  
  6405.        NOTES:
  6406.  
  6407.        1) In the event that no one is available to take a support call, it is
  6408.           our policy to return calls from non-registered users on an
  6409.           as-available basis.  This is necessary to allow us to serve our
  6410.           registered users on a higher priority basis.  This does not apply to
  6411.           those wishing to register CATDISK by phone with a VISA card.
  6412.  
  6413.        2) If you are not a registered user and do have questions, the best
  6414.           place to leave them is in an E-mail message on either on The
  6415.           Shareware Connection or on CompuServe.  In the case of The Shareware
  6416.           Connection, leave your message in a comment to the SYSOP or to Rick
  6417.           Hillier.
  6418.  
  6419.        3) The most up to date version of CATDISK is always available on The
  6420.           Shareware Connection BBS (number listed above).  Please note that to
  6421.           be able to obtain a new version of CATDISK, you must be a registered
  6422.           user and you must have taken the BBS Support option and must have
  6423.           remitted the applicable fee for this option.  This option will allow
  6424.           you to obtain perpetual upgrades to the CATDISK program, or any
  6425.           other shareware offering that may be made in the future.  We also
  6426.           maintain a growing library of excellent shareware products for your
  6427.           downloading pleasure.
  6428.  
  6429.           Please note that if you are not a registered with us under the above
  6430.           support plan, YOU WILL NOT BE ABLE TO ACCESS THE PROGRAM.  You may,
  6431.           however use the electronic mail features of the system to pose any
  6432.           questions you may have about CATDISK and/or obtain any missing
  6433.           documentation files and registration forms.
  6434.  
  6435.        -----------------------------------------------------------------------
  6436.  
  6437.        If you do have a question, or a bug report, or whatever, in your
  6438.        correspondence, please indicate the following:
  6439.  
  6440.        1)  The versions of CATDISK and DOS that you are using.
  6441.        2)  Your hardware configuration (Model, memory size, printer, etc.)
  6442.        3)  Any resident software that you have loaded in memory at the time.
  6443.            (i.e. Sidekick, SuperKey, Disk Caches, Print Spoolers, Ramdisks,
  6444.            etc.)
  6445.  
  6446.        This information will help us to track any problems and to suggest
  6447.        reasonable solutions to your problems.
  6448.  
  6449.  
  6450.  
  6451.  
  6452.  
  6453.  
  6454.  
  6455.  
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.  
  6465.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6466.  
  6467.                                       Page 97
  6468.  
  6469.  
  6470.  
  6471.                         APPENDIX H - QUESTIONS AND ANSWERS
  6472.  
  6473.        As CATDISK has developed over the past while, we have received many
  6474.        questions regarding the operation of CATDISK.  The most common are
  6475.        addressed in this section of the manual.
  6476.  
  6477.        Q. When I go to catalog a new disk, CATDISK aborts the catalog file
  6478.           update with an error message that the disk is full, even though
  6479.           there is still room on the disk containing the catalog files.
  6480.  
  6481.        A. When CATDISK updates a catalog file, it does so by merging the new
  6482.           information in with the old, building a new file from the old in the
  6483.           process.  The catch here is that, at the end of the catalog file
  6484.           update, BOTH files actually exist, thereby taking up roughly double
  6485.           the size of the original catalog file.  At the end of this
  6486.           procedure, if successful, CATDISK deletes the old file and renames
  6487.           the new temporary file to what the original catalog file was called.
  6488.           The reason this is necessary is that, while re-cataloging a disk,
  6489.           there is a possibility that files were removed from that disk.  This
  6490.           method of updating the catalog provides a convenient mechanism for
  6491.           removing those files from the catalog.  It also ensures the
  6492.           integrity of your catalog file.  If the power goes out while the
  6493.           update is in progress, you will still have your original catalog
  6494.           (from before the cataloging operation) intact.
  6495.  
  6496.        Q. CATDISK currently supports archive file comments in ZIP, ZOO, ARJ
  6497.           and DWC files.  Would it be possible to extract those from ARC files
  6498.           as well?
  6499.  
  6500.        A. ARC file comments were a non-standard extension provided by PKWare's
  6501.           PKARC/PKPAK series of archivers, and as such are not supported at
  6502.           this time.
  6503.  
  6504.        Q. Would it be possible for CATDISK to support ARCHIVES within
  6505.           ARCHIVES?
  6506.  
  6507.        A. Unfortunately, the answer is no.  In order to read the directory of
  6508.           an archive within another archive file, the original one must first
  6509.           be expanded into its separate files.  Firstly, with the ever
  6510.           evolving compression methods employed with new versions of the
  6511.           archive utilities, this would be beyond the scope of this program.
  6512.  
  6513.           Secondly, there would always be the possibility of overwriting an
  6514.           existing file of the same name.  It's just not feasible.
  6515.  
  6516.        Q. Is it possible for CATDISK to support file categories?
  6517.  
  6518.        A. Indirectly, CATDISK already supports file categories.  By searching
  6519.           your catalog file by keywords from the reports menu, and by starting
  6520.           each file comment with a category code, you can effectively
  6521.           implement file catagories.
  6522.  
  6523.           In a sample scenario, you could come up with a list of three letter
  6524.           abbreviations for your category list (eg. WIN for Windows, SPR for
  6525.           Spreadsheets, DBS for Database, COM for Communications, etc.) and
  6526.           start each comment with these categories.  By searching for "WIN",
  6527.           you can bring up a list of files in that category.  By sorting on
  6528.           comment, you can bring up a list of filenames sorted by category.
  6529.           Your imagination is the only limiting factor.
  6530.  
  6531.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6532.  
  6533.                                       Page 98
  6534.  
  6535.  
  6536.  
  6537.        Q. In the summary report, I see disk entries for which the amount of
  6538.           free space and the amount of space used adds up to more than the
  6539.           capacity of the disk itself.  The % slack factor is also wrong.
  6540.  
  6541.        A. You probably have a corrupted file allocation table on that disk,
  6542.           and could be in for some serious trouble.  Format a fresh disk and
  6543.           transfer the files to it, and re-catalog it from that new disk.
  6544.  
  6545.        Q. After starting the cataloging process on a diskette, I discovered
  6546.           that the label on the diskette was wrong.  Would it be possible to
  6547.           abort the process, change the label and start over?
  6548.  
  6549.        A. Once the cataloging process is started, it cannot be stopped.  If
  6550.           you've run into a situation like that above, let CATDISK finish the
  6551.           task, and use option #3 to change the label on the diskette.
  6552.           CATDISK has a mechanism to automatically change the old volume label
  6553.           to the new one throughout the catalog files.  It's quick and
  6554.           painless.
  6555.  
  6556.        Q. I have some self-booting games.  Would it be possible to create a
  6557.           dummy entry for that disk in the catalog?
  6558.  
  6559.        A. Doing this would defeat the purpose for which CATDISK was written.
  6560.           Self-booting games (those that CATDISK won't read) do not have a
  6561.           directory in the conventional sense.  As there are no files per se
  6562.           there is nothing to look for on the diskette.  You need only locate
  6563.           the disk itself in order to use it.
  6564.  
  6565.        Q. Is it possible for CATDISK to only catalog the disk itself, and not
  6566.           the files on it.
  6567.  
  6568.        A. Doing so would defeat the purpose of using CATDISK.  The whole idea
  6569.           behind CATDISK is to be able to locate files on your disks.  You can
  6570.           see the physical label on a disk, but the files themselves are
  6571.           invisible until you read it in your disk drive.  If all you need is
  6572.           to find a known disk, a good filing system is the way to go.
  6573.  
  6574.        Q. I have many disks with numerous insignificant files on them such as
  6575.           printer drivers, etc.  Would it be possible to catalog only selected
  6576.           files from these disks?
  6577.  
  6578.        A. Yes.  There are settings in the configuration utility, CDISKCFG.EXE
  6579.           that allow you to set file include and exclude specs via multiple
  6580.           wildcard specifications for each set.  CATDISK PLUS, a commercial
  6581.           release of this program with many enhancements described in more
  6582.           detail in a later appendix, will handle this type of operation with
  6583.           more flexibility.
  6584.  
  6585.        Q. DISKFILL seems to be missing certain disks in my catalog when
  6586.           recommending disks for backfilling.  I know that these disks have
  6587.           enough room to take one or more of the files I have tagged.  What's
  6588.           wrong?
  6589.  
  6590.        A. Check the "Squelch Specs" list in the configuration utility,
  6591.           DISKFILL.  The disks to which you are referring probably match one
  6592.           of the specifications contained in that list, in which case, they
  6593.           will be excluded from the list of disks to recommend for
  6594.           backfilling.
  6595.  
  6596.  
  6597.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6598.  
  6599.                                       Page 99
  6600.  
  6601.  
  6602.  
  6603.        Q. I've noticed that CATDISK seems to have missed some files on my hard
  6604.           disk when I list the catalog entries for that disk.
  6605.  
  6606.        A. CATDISK presently has an internal limitation of being able to
  6607.           remember only the first 5500 files that it sees (either in the
  6608.           directories themselves, or in any archive files whose contents are
  6609.           included in the catalog.  After it reaches this number, it will stop
  6610.           and begin cataloging the files read in.  The limitation of 6000
  6611.           files may, in fact, be lower if you do not have enough memory to
  6612.           accommodate them all.  If this is the case, you should remove some
  6613.           or all of your resident programs to free up valuable system memory
  6614.           for CATDISK to use.
  6615.  
  6616.           Also, adjusting the "disks/files per catalog" setting via the
  6617.           CDISKCFG program to the lowest value that will accommodate your
  6618.           largest catalog file will also free up some memory.
  6619.  
  6620.           If you have an 80286 computer or higher with sufficient extended
  6621.           memory, you can also use CATDISK/D (also available as shareware).
  6622.           This version can use your extended memory to attain much higher
  6623.           capacities than are possible with the standard version of CATDISK
  6624.           (up to 65500 files on the disk being cataloged).
  6625.  
  6626.        A. Another reason that this may occur, especially if your disk has less
  6627.           than 5500 entries is that the missing files may match a filespec set
  6628.           in the EXCLUDE FILES LIST that can be changed in the CDISKCFG
  6629.           utility.  Check that list out to see if this is the case.
  6630.  
  6631.        Q. Why does CATDISK slow down as my catalog files grow larger.
  6632.  
  6633.        A. As CATDISK catalogs each disk, it must make a pass through your data
  6634.           file to determine whether or not any files have been deleted or
  6635.           changed, so that the catalog file can be updated accordingly.  Many
  6636.           other disk catalogers on the market that outperform CATDISK in their
  6637.           cataloging operation retain the entire catalog in RAM.  While this
  6638.           is fast, there are two problems with it.
  6639.  
  6640.           Firstly, this imposes an extreme limitation on their ultimate
  6641.           capacity in terms of how many disks and files you can catalog.  If
  6642.           you are serious at all about maintaining a catalog of all your files
  6643.           and that your library will possibly grow to many files, these types
  6644.           of catalogers are not at all suitable for your usage.
  6645.  
  6646.           Secondly, if you should experience a power outage before you've
  6647.           saved your work, you can kiss that work good-bye.  By manipulating
  6648.           data on-disk, CATDISK does catalog your disks at a slower rate than
  6649.           the above mentioned type of cataloger, but it guarantees the
  6650.           integrity of your work.  We have also developed some very fast
  6651.           catalog updating routines, so any slowdown will be kept to a minimum
  6652.           while guaranteeing the integrity of your catalog file.
  6653.  
  6654.        Q. In DISKFILL, I have told it to call upon CATDISK to catalog each
  6655.           disk as it is filled, but at the end of each disk, the screen
  6656.           quickly blanks and then I am returned to DISKFILL.
  6657.  
  6658.        A. You probably do not have the directory where the program file
  6659.           CATDISK.EXE resides included in your DOS PATH.  DISKFILL is unable
  6660.           to ascertain whether or not CATDISK.EXE could be found and executed
  6661.           so that an appropriate error message can be displayed.
  6662.  
  6663.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6664.  
  6665.                                      Page 100
  6666.  
  6667.  
  6668.  
  6669.                       APPENDIX I - CATDISK COMPANION PROGRAMS
  6670.  
  6671.        Since its initial release in October 1986, CATDISK has grown steadily
  6672.        in popularity, and has become one of the leading cataloging programs
  6673.        available, due largely in part that it does not try be an
  6674.        everything-in-one software package.  The philosophy behind CATDISK has
  6675.        always been and always will be to provide a reliable, simple to use
  6676.        cataloging utility that performs the essential tasks of identifying the
  6677.        location(s) of individual files in a collection of disks.
  6678.  
  6679.        We will be the first to admit that there are many new functions and
  6680.        reports that CATDISK could do and does not due to the above mentioned
  6681.        philosophy.
  6682.  
  6683.        Several enterprising individuals have created companion programs to
  6684.        CATDISK that enhance its functionality.  They are briefly described
  6685.        here, along with the authors' names and addresses.
  6686.  
  6687.        All of these programs may be obtained from our support board, The
  6688.        Shareware Connection.  They are located in file area 1 on the main
  6689.        board.  As a service to the authors of these products, we have made
  6690.        them all available to ANYONE calling in to the system.  You do NOT need
  6691.        to be registered with us under the support BBS option in order to be
  6692.        able to obtain these programs.  You may also be able to find these
  6693.        programs on your local bulletin board systems as well.
  6694.  
  6695.        If your program is already listed in this section of the user manual,
  6696.        we ask that you keep us up to date on your creation by either uploading
  6697.        it to The Shareware Connection, or by sending it to us on disk at our
  6698.        regular address for registrations.  Many CATDISK users (registered and
  6699.        unregistered) call in to the board and check on the latest offerings,
  6700.        and do in fact download all of the programs listed.  If you have
  6701.        created a new program that is not listed here, please feel free to
  6702.        submit it.  If it's good, we'll "advertise" it for you here and on The
  6703.        Shareware Connection.
  6704.  
  6705.        CAT-STAT
  6706.  
  6707.        Cat-stat is a CATDISK-specific program that has two primary functions.
  6708.        It can scan your catalog file and generate some handy statistics on the
  6709.        data in your catalog file.  Ever wondered just how many megabytes worth
  6710.        of floppies you have in your collection?  This program will tell you
  6711.        that.  Its primary function, though, is to compare two CATDISK catalog
  6712.        files and tell you what files are in catalog file "A" that are not in
  6713.        "B" and vice versa.  It's great to have if you are trading files with a
  6714.        friend.
  6715.  
  6716.        Again, this program is menu-driven and very easy to use.
  6717.  
  6718.        Cat-stat is written by George Wilken and Bill Guy, and a $10 shareware
  6719.        registration fee is requested if you decide to use it.
  6720.  
  6721.        Send registrations to:  George Wilken
  6722.                                702 Deering Drive
  6723.                                Akron, OH
  6724.                                USA  44313
  6725.  
  6726.        Questions or comments may be left for the authors on CompuServe at
  6727.        71450,3172.
  6728.  
  6729.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6730.  
  6731.                                      Page 101
  6732.  
  6733.  
  6734.  
  6735.        DISK LABEL SYSTEM (DLS)
  6736.  
  6737.        One of the many requests that I have received for CATDISK to include is
  6738.        a facility to print disk labels.  The main reason that CATDISK does not
  6739.        currently have this capability is mainly due to our philosophy of
  6740.        providing a single-purpose utility that does what it does best.
  6741.  
  6742.        The good news is that this program is capable of producing disk labels
  6743.        directly from your CATDISK catalog file(s).  Additionally, it can read
  6744.        the directory information directly from a diskette if inserted in the
  6745.        floppy drive.  DLS can produce labels for 5.25" and 3.5" diskettes, as
  6746.        well as disk inserts for 5.25" diskettes.
  6747.  
  6748.        DLS is quite powerful, but is very easy to use.
  6749.  
  6750.        Several popular printers are supported.
  6751.  
  6752.        DLS is shareware, and a $15 registration fee is requested if you find
  6753.        the program useful.
  6754.  
  6755.         Author: James A. Clark
  6756.        Address: 2015 Pleasantview Drive
  6757.                 Marion, IA
  6758.                 USA  52302
  6759.          Phone: (319) 373-8896
  6760.  
  6761.        THE CATDISK UTILITIES (CDU)
  6762.  
  6763.        This collection of handy programs expands on some of the functionality
  6764.        of CATDISK.
  6765.  
  6766.        CDC pads the excess characters in the comment field with spaces (newer
  6767.        versions of CATDISK, including this release do the same), resulting in
  6768.        better compression of the data file when using programs like STACKER or
  6769.        other compression programs.
  6770.  
  6771.        CDR allows a search of the database by up to 50 wildcard specs and
  6772.        allows you to delete those files from your diskettes by prompting you
  6773.        to mount each disk as appropriate.  It will then call on CATDISK to
  6774.        update the catalog file when each disk has been cleaned up.
  6775.  
  6776.        CDF is an enhanced reporting facility.
  6777.  
  6778.        CDM assists in offloading files to floppies.
  6779.  
  6780.        CDS assists in finding files on floppies and copies them to a hard disk
  6781.        subdirectory.
  6782.  
  6783.        These utilities are written by:
  6784.  
  6785.        Robert w. Van Hoeven
  6786.        P.O. Box 131
  6787.        1170 AC Badhoevedorp
  6788.  
  6789.        Nederland / Holland
  6790.  
  6791.        Questions or comments may be left to "Rob van.Hoeven" (note the period
  6792.        in the last name - it must be there) at NetMail address 2:512/100, or
  6793.        better, 2:512/100.5, or in the FidoNet DISP echomail area.
  6794.  
  6795.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6796.  
  6797.                                      Page 102
  6798.  
  6799.  
  6800.  
  6801.        CAT2DIR v2.0
  6802.  
  6803.        Makes an ASCII file of the CATDISK.DTA file and optionally, a 0 byte
  6804.        file for each file listed in the catalog file.  Useful for PC Board
  6805.        sysops who list off-line files that were never online, so are not in any
  6806.        BBS file directory.  Can block duplicate uploads.
  6807.  
  6808.        This program is released as FREEWARE by:
  6809.  
  6810.        Scott Johnson
  6811.        4205 Long Key Lane #1526
  6812.        Winter Park, FL
  6813.        USA  32792
  6814.  
  6815.        BBS: The Freeware Hall of Fame (Rey Barry, SYSOP)
  6816.             (804) 293-4710  (USR DS 2400-14,400 BPS
  6817.  
  6818.  
  6819.  
  6820.  
  6821.  
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.  
  6829.  
  6830.  
  6831.  
  6832.  
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.  
  6839.  
  6840.  
  6841.  
  6842.  
  6843.  
  6844.  
  6845.  
  6846.  
  6847.  
  6848.  
  6849.  
  6850.  
  6851.  
  6852.  
  6853.  
  6854.  
  6855.  
  6856.  
  6857.  
  6858.  
  6859.  
  6860.  
  6861.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6862.  
  6863.                                      Page 103
  6864.  
  6865.  
  6866.  
  6867.                        APPENDIX J - OTHER PRODUCTS AVAILABLE
  6868.  
  6869.        For all you avid golfers out there, I have released a golf handicap
  6870.        system, called HANDICAP II, that goes way beyond just calculating a
  6871.        simple golf handicap.
  6872.  
  6873.        Among the many features of this program are:
  6874.  
  6875.          . Pull down menus for ease of use.
  6876.          . On line context sensitive help.
  6877.          . Storage capacity for up to 400 different golf courses.
  6878.          . Storage capacity for up to 128000 rounds of golf (if you exceed
  6879.            this number, I want to meet you!).
  6880.            (score and number of putts on each hole can be logged)
  6881.          . Instant retrieval of past played games, and the ability to browse
  6882.            through them.
  6883.          . An expanded handicap card that is more informative than a standard
  6884.            handicap card.
  6885.          . A report showing your average score on each hole on each course.
  6886.            - good for spotting habitual trouble holes.
  6887.          . A report showing your average putts on each green on each course.
  6888.            - good for spotting habitual troublesome greens.
  6889.          . A report showing how often you hit each green in regulation.
  6890.            - good for analyzing your tee-to-green game on each hole.
  6891.          . Many more statistical reports of interest to you.
  6892.          . Full housekeeping routines to correct mistakes (but I'll bet that
  6893.            you never make any, right?!?)
  6894.  
  6895.          . ALL reports may be viewed on the screen or printed on your
  6896.            printer.
  6897.  
  6898.          . Pop up windows are used extensively, adding to the ease of use of
  6899.            the program.
  6900.  
  6901.        We also have a clubhouse version available with all of the above plus:
  6902.  
  6903.          . A simple date-differential entry system for those who do not wish
  6904.            to have all the detail of the enhanced reports.
  6905.          . Capacity to maintain handicaps for up to 128000 members (you are
  6906.            only limited by disk size).
  6907.          . Full system manager functions available only to authorized users.
  6908.          . A handicap listing (in alphabetical order by member name) of the
  6909.            handicaps of all the members in the system.
  6910.  
  6911.                                  Ordering Information
  6912.  
  6913.        The GOLFERS version of HANDICAP II is available as shareware for $35
  6914.        directly from myself (Rick Hillier), and the CLUB HOUSE version is
  6915.        available for $295.00 (which includes a bound, printed manual) from the
  6916.        address below.
  6917.  
  6918.        They may be ordered from:  Rick Hillier
  6919.                                   98 Toynbee Crescent
  6920.                                   Kitchener, Ontario
  6921.                                   Canada   N2N 1R9
  6922.                           Phone:  (519) 570-3523
  6923.                             FAX:  (519) 884-4887
  6924.                             BBS:  (519) 570-4132
  6925.  
  6926.  
  6927.       Disk Catalog System (CATDISK) V7.04  Copr (C) 1986-1993 by Rick Hillier
  6928.  
  6929.                                      Page 104
  6930.  
  6931.